@venizia/ignis-connectors 0.4.0 → 0.4.2

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 (193) hide show
  1. package/dist/cjs/common/scope-filter.d.ts +1 -1
  2. package/dist/cjs/common/scope-filter.d.ts.map +1 -1
  3. package/dist/cjs/common/scope-filter.js +33 -7
  4. package/dist/cjs/common/scope-filter.js.map +1 -1
  5. package/dist/cjs/http/repository.d.ts +23 -23
  6. package/dist/cjs/http/repository.d.ts.map +1 -1
  7. package/dist/cjs/http/repository.js.map +1 -1
  8. package/dist/cjs/relational/core/datasources/base.d.ts.map +1 -1
  9. package/dist/cjs/relational/core/datasources/base.js +1 -1
  10. package/dist/cjs/relational/core/datasources/base.js.map +1 -1
  11. package/dist/cjs/relational/core/migrations/runner.js +3 -3
  12. package/dist/cjs/relational/core/migrations/runner.js.map +1 -1
  13. package/dist/cjs/relational/core/models/base.js +1 -1
  14. package/dist/cjs/relational/core/models/base.js.map +1 -1
  15. package/dist/cjs/relational/core/repositories/common/scope-write-guard.d.ts +50 -0
  16. package/dist/cjs/relational/core/repositories/common/scope-write-guard.d.ts.map +1 -0
  17. package/dist/cjs/relational/core/repositories/common/scope-write-guard.js +248 -0
  18. package/dist/cjs/relational/core/repositories/common/scope-write-guard.js.map +1 -0
  19. package/dist/cjs/relational/core/repositories/core/base.d.ts +35 -20
  20. package/dist/cjs/relational/core/repositories/core/base.d.ts.map +1 -1
  21. package/dist/cjs/relational/core/repositories/core/base.js +29 -4
  22. package/dist/cjs/relational/core/repositories/core/base.js.map +1 -1
  23. package/dist/cjs/relational/core/repositories/core/persistable.d.ts.map +1 -1
  24. package/dist/cjs/relational/core/repositories/core/persistable.js +6 -1
  25. package/dist/cjs/relational/core/repositories/core/persistable.js.map +1 -1
  26. package/dist/cjs/relational/core/repositories/core/readable.d.ts +17 -17
  27. package/dist/cjs/relational/core/repositories/core/readable.d.ts.map +1 -1
  28. package/dist/cjs/relational/core/repositories/core/readable.js +8 -2
  29. package/dist/cjs/relational/core/repositories/core/readable.js.map +1 -1
  30. package/dist/cjs/relational/core/repositories/core/soft-deletable.d.ts +9 -9
  31. package/dist/cjs/relational/core/repositories/core/soft-deletable.d.ts.map +1 -1
  32. package/dist/cjs/relational/core/repositories/core/soft-deletable.js.map +1 -1
  33. package/dist/cjs/relational/core/repositories/dialect/filter.d.ts +2 -2
  34. package/dist/cjs/relational/core/repositories/dialect/filter.js +6 -6
  35. package/dist/cjs/relational/core/repositories/dialect/filter.js.map +1 -1
  36. package/dist/cjs/relational/core/repositories/dialect/relations/one.d.ts.map +1 -1
  37. package/dist/cjs/relational/core/repositories/dialect/relations/one.js +7 -7
  38. package/dist/cjs/relational/core/repositories/dialect/relations/one.js.map +1 -1
  39. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts +9 -0
  40. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  41. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js +17 -6
  42. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  43. package/dist/cjs/relational/postgres/drivers/pglite.js +2 -2
  44. package/dist/cjs/relational/postgres/drivers/pglite.js.map +1 -1
  45. package/dist/cjs/relational/postgres/repositories/dialect/query.js +1 -1
  46. package/dist/cjs/relational/postgres/repositories/dialect/query.js.map +1 -1
  47. package/dist/cjs/relational/sqlite/drivers/libsql.js +2 -2
  48. package/dist/cjs/relational/sqlite/drivers/libsql.js.map +1 -1
  49. package/dist/cjs/relational/sqlite/repositories/dialect/internal/json-path.js +3 -3
  50. package/dist/cjs/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  51. package/dist/cjs/search/core/connector.js +2 -2
  52. package/dist/cjs/search/core/connector.js.map +1 -1
  53. package/dist/cjs/search/core/controllers/abstract.d.ts +4 -0
  54. package/dist/cjs/search/core/controllers/abstract.d.ts.map +1 -1
  55. package/dist/cjs/search/core/controllers/abstract.js +15 -1
  56. package/dist/cjs/search/core/controllers/abstract.js.map +1 -1
  57. package/dist/cjs/search/core/controllers/factory.d.ts +14 -0
  58. package/dist/cjs/search/core/controllers/factory.d.ts.map +1 -1
  59. package/dist/cjs/search/core/controllers/factory.js +7 -1
  60. package/dist/cjs/search/core/controllers/factory.js.map +1 -1
  61. package/dist/cjs/search/core/controllers/scope.d.ts +28 -0
  62. package/dist/cjs/search/core/controllers/scope.d.ts.map +1 -0
  63. package/dist/cjs/search/core/controllers/scope.js +68 -0
  64. package/dist/cjs/search/core/controllers/scope.js.map +1 -0
  65. package/dist/cjs/search/core/datasources/base.js +2 -2
  66. package/dist/cjs/search/core/datasources/base.js.map +1 -1
  67. package/dist/cjs/search/core/models/define-search-collection.js +3 -3
  68. package/dist/cjs/search/core/models/define-search-collection.js.map +1 -1
  69. package/dist/cjs/search/core/models/zod-derivation.js +1 -1
  70. package/dist/cjs/search/core/models/zod-derivation.js.map +1 -1
  71. package/dist/cjs/search/core/repositories/common/dialect-helpers.js +1 -1
  72. package/dist/cjs/search/core/repositories/common/dialect-helpers.js.map +1 -1
  73. package/dist/cjs/search/core/repositories/core/base.js +2 -2
  74. package/dist/cjs/search/core/repositories/core/base.js.map +1 -1
  75. package/dist/cjs/search/core/repositories/core/readable.d.ts +17 -17
  76. package/dist/cjs/search/core/repositories/core/readable.d.ts.map +1 -1
  77. package/dist/cjs/search/core/repositories/core/readable.js +4 -4
  78. package/dist/cjs/search/core/repositories/core/readable.js.map +1 -1
  79. package/dist/cjs/search/meilisearch/compiler.js +4 -4
  80. package/dist/cjs/search/meilisearch/compiler.js.map +1 -1
  81. package/dist/cjs/search/meilisearch/connector.js +22 -22
  82. package/dist/cjs/search/meilisearch/connector.js.map +1 -1
  83. package/dist/cjs/search/meilisearch/internal/connector-internal.js +1 -1
  84. package/dist/cjs/search/meilisearch/internal/connector-internal.js.map +1 -1
  85. package/dist/cjs/search/meilisearch/repositories/dialect/query-dialect.js +6 -6
  86. package/dist/cjs/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  87. package/dist/cjs/search/typesense/compiler.js +8 -8
  88. package/dist/cjs/search/typesense/compiler.js.map +1 -1
  89. package/dist/cjs/search/typesense/connector.js +23 -23
  90. package/dist/cjs/search/typesense/connector.js.map +1 -1
  91. package/dist/cjs/search/typesense/internal/mappers.js +1 -1
  92. package/dist/cjs/search/typesense/internal/mappers.js.map +1 -1
  93. package/dist/cjs/search/typesense/internal/pagination-windows.js +3 -3
  94. package/dist/cjs/search/typesense/internal/pagination-windows.js.map +1 -1
  95. package/dist/cjs/search/typesense/repositories/dialect/query-dialect.js +7 -7
  96. package/dist/cjs/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  97. package/dist/esm/common/scope-filter.d.ts +1 -1
  98. package/dist/esm/common/scope-filter.d.ts.map +1 -1
  99. package/dist/esm/common/scope-filter.js +34 -8
  100. package/dist/esm/common/scope-filter.js.map +1 -1
  101. package/dist/esm/http/repository.d.ts +23 -23
  102. package/dist/esm/http/repository.d.ts.map +1 -1
  103. package/dist/esm/http/repository.js.map +1 -1
  104. package/dist/esm/relational/core/datasources/base.d.ts.map +1 -1
  105. package/dist/esm/relational/core/datasources/base.js +1 -1
  106. package/dist/esm/relational/core/datasources/base.js.map +1 -1
  107. package/dist/esm/relational/core/migrations/runner.js +3 -3
  108. package/dist/esm/relational/core/migrations/runner.js.map +1 -1
  109. package/dist/esm/relational/core/models/base.js +1 -1
  110. package/dist/esm/relational/core/models/base.js.map +1 -1
  111. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts +50 -0
  112. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts.map +1 -0
  113. package/dist/esm/relational/core/repositories/common/scope-write-guard.js +244 -0
  114. package/dist/esm/relational/core/repositories/common/scope-write-guard.js.map +1 -0
  115. package/dist/esm/relational/core/repositories/core/base.d.ts +35 -20
  116. package/dist/esm/relational/core/repositories/core/base.d.ts.map +1 -1
  117. package/dist/esm/relational/core/repositories/core/base.js +29 -4
  118. package/dist/esm/relational/core/repositories/core/base.js.map +1 -1
  119. package/dist/esm/relational/core/repositories/core/persistable.d.ts.map +1 -1
  120. package/dist/esm/relational/core/repositories/core/persistable.js +6 -1
  121. package/dist/esm/relational/core/repositories/core/persistable.js.map +1 -1
  122. package/dist/esm/relational/core/repositories/core/readable.d.ts +17 -17
  123. package/dist/esm/relational/core/repositories/core/readable.d.ts.map +1 -1
  124. package/dist/esm/relational/core/repositories/core/readable.js +8 -2
  125. package/dist/esm/relational/core/repositories/core/readable.js.map +1 -1
  126. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts +9 -9
  127. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts.map +1 -1
  128. package/dist/esm/relational/core/repositories/core/soft-deletable.js.map +1 -1
  129. package/dist/esm/relational/core/repositories/dialect/filter.d.ts +2 -2
  130. package/dist/esm/relational/core/repositories/dialect/filter.js +6 -6
  131. package/dist/esm/relational/core/repositories/dialect/filter.js.map +1 -1
  132. package/dist/esm/relational/core/repositories/dialect/relations/one.d.ts.map +1 -1
  133. package/dist/esm/relational/core/repositories/dialect/relations/one.js +7 -7
  134. package/dist/esm/relational/core/repositories/dialect/relations/one.js.map +1 -1
  135. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts +9 -0
  136. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  137. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js +18 -7
  138. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  139. package/dist/esm/relational/postgres/drivers/pglite.js +2 -2
  140. package/dist/esm/relational/postgres/drivers/pglite.js.map +1 -1
  141. package/dist/esm/relational/postgres/repositories/dialect/query.js +1 -1
  142. package/dist/esm/relational/postgres/repositories/dialect/query.js.map +1 -1
  143. package/dist/esm/relational/sqlite/drivers/libsql.js +2 -2
  144. package/dist/esm/relational/sqlite/drivers/libsql.js.map +1 -1
  145. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js +3 -3
  146. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  147. package/dist/esm/search/core/connector.js +2 -2
  148. package/dist/esm/search/core/connector.js.map +1 -1
  149. package/dist/esm/search/core/controllers/abstract.d.ts +4 -0
  150. package/dist/esm/search/core/controllers/abstract.d.ts.map +1 -1
  151. package/dist/esm/search/core/controllers/abstract.js +15 -1
  152. package/dist/esm/search/core/controllers/abstract.js.map +1 -1
  153. package/dist/esm/search/core/controllers/factory.d.ts +14 -0
  154. package/dist/esm/search/core/controllers/factory.d.ts.map +1 -1
  155. package/dist/esm/search/core/controllers/factory.js +7 -1
  156. package/dist/esm/search/core/controllers/factory.js.map +1 -1
  157. package/dist/esm/search/core/controllers/scope.d.ts +28 -0
  158. package/dist/esm/search/core/controllers/scope.d.ts.map +1 -0
  159. package/dist/esm/search/core/controllers/scope.js +64 -0
  160. package/dist/esm/search/core/controllers/scope.js.map +1 -0
  161. package/dist/esm/search/core/datasources/base.js +2 -2
  162. package/dist/esm/search/core/datasources/base.js.map +1 -1
  163. package/dist/esm/search/core/models/define-search-collection.js +3 -3
  164. package/dist/esm/search/core/models/define-search-collection.js.map +1 -1
  165. package/dist/esm/search/core/models/zod-derivation.js +1 -1
  166. package/dist/esm/search/core/models/zod-derivation.js.map +1 -1
  167. package/dist/esm/search/core/repositories/common/dialect-helpers.js +1 -1
  168. package/dist/esm/search/core/repositories/common/dialect-helpers.js.map +1 -1
  169. package/dist/esm/search/core/repositories/core/base.js +2 -2
  170. package/dist/esm/search/core/repositories/core/base.js.map +1 -1
  171. package/dist/esm/search/core/repositories/core/readable.d.ts +17 -17
  172. package/dist/esm/search/core/repositories/core/readable.d.ts.map +1 -1
  173. package/dist/esm/search/core/repositories/core/readable.js +4 -4
  174. package/dist/esm/search/core/repositories/core/readable.js.map +1 -1
  175. package/dist/esm/search/meilisearch/compiler.js +4 -4
  176. package/dist/esm/search/meilisearch/compiler.js.map +1 -1
  177. package/dist/esm/search/meilisearch/connector.js +22 -22
  178. package/dist/esm/search/meilisearch/connector.js.map +1 -1
  179. package/dist/esm/search/meilisearch/internal/connector-internal.js +1 -1
  180. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  181. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js +6 -6
  182. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  183. package/dist/esm/search/typesense/compiler.js +8 -8
  184. package/dist/esm/search/typesense/compiler.js.map +1 -1
  185. package/dist/esm/search/typesense/connector.js +23 -23
  186. package/dist/esm/search/typesense/connector.js.map +1 -1
  187. package/dist/esm/search/typesense/internal/mappers.js +1 -1
  188. package/dist/esm/search/typesense/internal/mappers.js.map +1 -1
  189. package/dist/esm/search/typesense/internal/pagination-windows.js +3 -3
  190. package/dist/esm/search/typesense/internal/pagination-windows.js.map +1 -1
  191. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js +7 -7
  192. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  193. package/package.json +7 -7
@@ -0,0 +1,244 @@
1
+ import { getError } from '@venizia/ignis-helpers/core';
2
+ import { QueryOperators, RepositoryErrorCodes, ScopeFilterMissingBehaviors, ScopeFilters, ScopeWriteGuards, } from '@venizia/ignis-kernel';
3
+ import { HTTP } from '@venizia/ignis-helpers/common';
4
+ const WRITE_DENIED_STATUS = HTTP.ResultCodes.RS_4.Forbidden;
5
+ const isScalar = (value) => {
6
+ return (value === null ||
7
+ value instanceof Date ||
8
+ ['string', 'number', 'bigint', 'boolean'].includes(typeof value));
9
+ };
10
+ const normalise = (value) => {
11
+ if (value === null) {
12
+ return null;
13
+ }
14
+ return value instanceof Date ? value.toISOString() : String(value);
15
+ };
16
+ const intersect = (opts) => {
17
+ return new Set([...opts.left].filter((value) => opts.right.has(value)));
18
+ };
19
+ /**
20
+ * The write side of `@model` settings.access. The resolved scope is a `where`; the guard reads
21
+ * from it the columns it constrains and the values it allows, and holds every written row to them.
22
+ *
23
+ * Only shapes that can be checked are read: a column equal to a scalar or `null`, `{ eq }`, `{ inq }`
24
+ * (or `in`), an array, `and` of those, and an `or` whose branches all constrain the same column. Anything
25
+ * else - an `or` over several columns, ranges, `like`, a nested path - makes
26
+ * the scope unverifiable, and the write is refused with its own message instead of being skipped.
27
+ */
28
+ export class ScopeWriteGuard {
29
+ static extractConstraints(opts) {
30
+ const constraints = new Map();
31
+ const reason = ScopeWriteGuard.collect({
32
+ where: opts.where,
33
+ constraints,
34
+ });
35
+ return reason === undefined
36
+ ? { isVerifiable: true, constraints }
37
+ : { isVerifiable: false, reason };
38
+ }
39
+ /** Adds the where's constraints to `constraints`; returns the reason it cannot be verified, if any. */
40
+ static collect(opts) {
41
+ const { where, constraints } = opts;
42
+ for (const [key, value] of Object.entries(where)) {
43
+ if (key === 'and') {
44
+ if (!Array.isArray(value)) {
45
+ return "'and' is not a list";
46
+ }
47
+ for (const part of value) {
48
+ const reason = ScopeWriteGuard.collect({
49
+ where: part,
50
+ constraints,
51
+ });
52
+ if (reason !== undefined) {
53
+ return reason;
54
+ }
55
+ }
56
+ continue;
57
+ }
58
+ if (key === 'or') {
59
+ const union = ScopeWriteGuard.unionOfBranches({ branches: value });
60
+ if (typeof union === 'string') {
61
+ return union;
62
+ }
63
+ const existing = constraints.get(union.column);
64
+ constraints.set(union.column, existing ? intersect({ left: existing, right: union.allowed }) : union.allowed);
65
+ continue;
66
+ }
67
+ if (key.includes('.')) {
68
+ return `the nested path '${key}' cannot be checked on a write`;
69
+ }
70
+ const allowed = ScopeWriteGuard.allowedValues({ value });
71
+ if (typeof allowed === 'string') {
72
+ return `column '${key}': ${allowed}`;
73
+ }
74
+ const existing = constraints.get(key);
75
+ constraints.set(key, existing ? intersect({ left: existing, right: allowed }) : allowed);
76
+ }
77
+ return undefined;
78
+ }
79
+ /**
80
+ * An `or` is checkable only when every branch constrains the same single column with a scalar,
81
+ * `null`, `eq`, `in` or `inq`: the allowed values are then the union of the branches. This is the
82
+ * shared-rows scope, `{ or: [{ merchantId: { in: ids } }, { merchantId: null }] }`. Any other `or`
83
+ * (several columns, ranges, nested `and` or `or`) cannot be checked.
84
+ */
85
+ static unionOfBranches(opts) {
86
+ const { branches } = opts;
87
+ if (!Array.isArray(branches) || branches.length === 0) {
88
+ return "'or' is not a list";
89
+ }
90
+ let column;
91
+ const allowed = new Set();
92
+ for (const branch of branches) {
93
+ const entries = Object.entries((branch ?? {}));
94
+ if (entries.length !== 1) {
95
+ return "an 'or' branch with several conditions cannot be checked on a write";
96
+ }
97
+ const [key, value] = entries[0];
98
+ if (key === 'and' || key === 'or' || key.includes('.')) {
99
+ return `an 'or' branch over '${key}' cannot be checked on a write`;
100
+ }
101
+ if (column !== undefined && column !== key) {
102
+ return "an 'or' over different columns cannot be checked on a write";
103
+ }
104
+ column = key;
105
+ const values = ScopeWriteGuard.allowedValues({ value });
106
+ if (typeof values === 'string') {
107
+ return `column '${key}': ${values}`;
108
+ }
109
+ values.forEach((entry) => allowed.add(entry));
110
+ }
111
+ return { column: column, allowed };
112
+ }
113
+ /** The values one column's condition allows, or a string naming why it cannot be checked. */
114
+ static allowedValues(opts) {
115
+ const { value } = opts;
116
+ if (isScalar(value)) {
117
+ return new Set([normalise(value)]);
118
+ }
119
+ if (Array.isArray(value)) {
120
+ return value.every(isScalar)
121
+ ? new Set(value.map(normalise))
122
+ : 'a list with a non-scalar entry';
123
+ }
124
+ if (typeof value !== 'object' || value === undefined) {
125
+ return 'an unsupported condition';
126
+ }
127
+ const operators = Object.keys(value);
128
+ if (operators.length !== 1) {
129
+ return `a condition with ${operators.length} operators cannot be checked on a write`;
130
+ }
131
+ const [operator] = operators;
132
+ const operand = value[operator];
133
+ if (operator === QueryOperators.EQ && isScalar(operand)) {
134
+ return new Set([normalise(operand)]);
135
+ }
136
+ if ((operator === QueryOperators.INQ || operator === QueryOperators.IN) &&
137
+ Array.isArray(operand)) {
138
+ return operand.every(isScalar)
139
+ ? new Set(operand.map(normalise))
140
+ : 'a list with a non-scalar entry';
141
+ }
142
+ return `the operator '${operator}' cannot be checked on a write`;
143
+ }
144
+ /**
145
+ * Holds `rows` to the scope `settings.resolve()` returns now. Returns the rows to write: the same
146
+ * objects when nothing changes, copies with the scope columns filled in for `assign`. Throws, and
147
+ * so writes nothing, when any row is outside the scope.
148
+ */
149
+ static apply(opts) {
150
+ const { settings, model, rows, operation } = opts;
151
+ const scope = settings.resolve();
152
+ if (scope === ScopeFilters.UNRESTRICTED) {
153
+ return rows;
154
+ }
155
+ if (scope === null || scope === undefined) {
156
+ // An update is already confined by the scoped `where`, which under `deny` matches no row; the
157
+ // guard adds nothing there. A create has no such `where`, so an unresolved scope refuses it.
158
+ if (settings.onMissing === ScopeFilterMissingBehaviors.ALLOW || operation === 'update') {
159
+ return rows;
160
+ }
161
+ throw ScopeWriteGuard.denied({
162
+ model,
163
+ operation,
164
+ detail: 'no scope could be resolved for this caller',
165
+ });
166
+ }
167
+ const extraction = ScopeWriteGuard.extractConstraints({ where: scope });
168
+ if (!extraction.isVerifiable) {
169
+ throw ScopeWriteGuard.denied({
170
+ model,
171
+ operation,
172
+ detail: `the resolved scope cannot be verified on a write | ${extraction.reason}`,
173
+ });
174
+ }
175
+ const { constraints } = extraction;
176
+ const declared = settings.columns;
177
+ if (declared) {
178
+ const undeclared = [...constraints.keys()].find((column) => !declared.includes(column));
179
+ if (undeclared !== undefined) {
180
+ throw ScopeWriteGuard.denied({
181
+ model,
182
+ operation,
183
+ detail: `the resolved scope constrains column '${undeclared}', which access.columns does not declare`,
184
+ });
185
+ }
186
+ }
187
+ const isAssign = settings.write?.mode === ScopeWriteGuards.ASSIGN && operation === 'create';
188
+ const sharedRows = settings.write?.sharedRows === true;
189
+ return rows.map((row) => {
190
+ let result = row;
191
+ for (const [column, allowed] of constraints) {
192
+ const value = row[column];
193
+ if (value === undefined) {
194
+ if (operation === 'update') {
195
+ continue;
196
+ }
197
+ // `assign` first: stamping gives the row an owner, which is safer than leaving it shared.
198
+ const only = allowed.size === 1 ? [...allowed][0] : undefined;
199
+ if (isAssign && only !== undefined && only !== null) {
200
+ result = { ...result, [column]: only };
201
+ continue;
202
+ }
203
+ // Absent means the database default, usually `null`, so it is held to the `null` rule.
204
+ if (sharedRows) {
205
+ continue;
206
+ }
207
+ throw ScopeWriteGuard.denied({
208
+ model,
209
+ operation,
210
+ column,
211
+ detail: 'the scope column is missing',
212
+ });
213
+ }
214
+ const normalised = isScalar(value) ? normalise(value) : undefined;
215
+ // A `null` branch in the scope lets this caller READ shared rows. Writing one (or moving a
216
+ // row into the shared set) is a separate permission: only `sharedRows` grants it.
217
+ const isOutside = normalised === null ? !sharedRows : !allowed.has(normalised);
218
+ if (normalised === undefined || isOutside) {
219
+ throw ScopeWriteGuard.denied({
220
+ model,
221
+ operation,
222
+ column,
223
+ detail: 'the value is outside the resolved scope',
224
+ });
225
+ }
226
+ }
227
+ return result;
228
+ });
229
+ }
230
+ /** Names the model and the column, never a value: the caller may be a request. */
231
+ static denied(opts) {
232
+ const { model, operation, column, detail } = opts;
233
+ return getError({
234
+ statusCode: WRITE_DENIED_STATUS,
235
+ messageCode: RepositoryErrorCodes.SCOPE_WRITE_DENIED,
236
+ message: [
237
+ `[${operation}] write refused by the access scope | entity: ${model}`,
238
+ ...(column ? [`column: ${column}`] : []),
239
+ detail,
240
+ ].join(' | '),
241
+ });
242
+ }
243
+ }
244
+ //# sourceMappingURL=scope-write-guard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope-write-guard.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/common/scope-write-guard.ts"],"names":[],"mappings":"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","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\nimport {\n QueryOperators,\n RepositoryErrorCodes,\n ScopeFilterMissingBehaviors,\n ScopeFilters,\n ScopeWriteGuards,\n} from '@venizia/ignis-kernel';\nimport type { IModelAccessSettings, TWhere } from '@venizia/ignis-kernel';\nimport { HTTP } from '@venizia/ignis-helpers/common';\n\ntype TScalar = string | number | bigint | boolean | Date | null;\n\n/** The allowed values per scope column, each normalised so `1` and `'1'` and equal dates compare equal. */\ntype TConstraints = Map<string, Set<string | null>>;\n\ntype TExtraction =\n | { isVerifiable: true; constraints: TConstraints }\n | { isVerifiable: false; reason: string };\n\nconst WRITE_DENIED_STATUS = HTTP.ResultCodes.RS_4.Forbidden;\n\nconst isScalar = (value: unknown): value is TScalar => {\n return (\n value === null ||\n value instanceof Date ||\n ['string', 'number', 'bigint', 'boolean'].includes(typeof value)\n );\n};\n\nconst normalise = (value: TScalar): string | null => {\n if (value === null) {\n return null;\n }\n\n return value instanceof Date ? value.toISOString() : String(value);\n};\n\nconst intersect = (opts: { left: Set<string | null>; right: Set<string | null> }) => {\n return new Set([...opts.left].filter((value) => opts.right.has(value)));\n};\n\n/**\n * The write side of `@model` settings.access. The resolved scope is a `where`; the guard reads\n * from it the columns it constrains and the values it allows, and holds every written row to them.\n *\n * Only shapes that can be checked are read: a column equal to a scalar or `null`, `{ eq }`, `{ inq }`\n * (or `in`), an array, `and` of those, and an `or` whose branches all constrain the same column. Anything\n * else - an `or` over several columns, ranges, `like`, a nested path - makes\n * the scope unverifiable, and the write is refused with its own message instead of being skipped.\n */\nexport class ScopeWriteGuard {\n static extractConstraints(opts: { where: TWhere }): TExtraction {\n const constraints: TConstraints = new Map();\n const reason = ScopeWriteGuard.collect({\n where: opts.where as Record<string, unknown>,\n constraints,\n });\n\n return reason === undefined\n ? { isVerifiable: true, constraints }\n : { isVerifiable: false, reason };\n }\n\n /** Adds the where's constraints to `constraints`; returns the reason it cannot be verified, if any. */\n private static collect(opts: {\n where: Record<string, unknown>;\n constraints: TConstraints;\n }): string | undefined {\n const { where, constraints } = opts;\n\n for (const [key, value] of Object.entries(where)) {\n if (key === 'and') {\n if (!Array.isArray(value)) {\n return \"'and' is not a list\";\n }\n\n for (const part of value) {\n const reason = ScopeWriteGuard.collect({\n where: part as Record<string, unknown>,\n constraints,\n });\n if (reason !== undefined) {\n return reason;\n }\n }\n\n continue;\n }\n\n if (key === 'or') {\n const union = ScopeWriteGuard.unionOfBranches({ branches: value });\n if (typeof union === 'string') {\n return union;\n }\n\n const existing = constraints.get(union.column);\n constraints.set(\n union.column,\n existing ? intersect({ left: existing, right: union.allowed }) : union.allowed,\n );\n continue;\n }\n\n if (key.includes('.')) {\n return `the nested path '${key}' cannot be checked on a write`;\n }\n\n const allowed = ScopeWriteGuard.allowedValues({ value });\n if (typeof allowed === 'string') {\n return `column '${key}': ${allowed}`;\n }\n\n const existing = constraints.get(key);\n constraints.set(key, existing ? intersect({ left: existing, right: allowed }) : allowed);\n }\n\n return undefined;\n }\n\n /**\n * An `or` is checkable only when every branch constrains the same single column with a scalar,\n * `null`, `eq`, `in` or `inq`: the allowed values are then the union of the branches. This is the\n * shared-rows scope, `{ or: [{ merchantId: { in: ids } }, { merchantId: null }] }`. Any other `or`\n * (several columns, ranges, nested `and` or `or`) cannot be checked.\n */\n private static unionOfBranches(opts: {\n branches: unknown;\n }): { column: string; allowed: Set<string | null> } | string {\n const { branches } = opts;\n\n if (!Array.isArray(branches) || branches.length === 0) {\n return \"'or' is not a list\";\n }\n\n let column: string | undefined;\n const allowed = new Set<string | null>();\n\n for (const branch of branches) {\n const entries = Object.entries((branch ?? {}) as Record<string, unknown>);\n if (entries.length !== 1) {\n return \"an 'or' branch with several conditions cannot be checked on a write\";\n }\n\n const [key, value] = entries[0];\n if (key === 'and' || key === 'or' || key.includes('.')) {\n return `an 'or' branch over '${key}' cannot be checked on a write`;\n }\n\n if (column !== undefined && column !== key) {\n return \"an 'or' over different columns cannot be checked on a write\";\n }\n\n column = key;\n const values = ScopeWriteGuard.allowedValues({ value });\n if (typeof values === 'string') {\n return `column '${key}': ${values}`;\n }\n\n values.forEach((entry) => allowed.add(entry));\n }\n\n return { column: column as string, allowed };\n }\n\n /** The values one column's condition allows, or a string naming why it cannot be checked. */\n private static allowedValues(opts: { value: unknown }): Set<string | null> | string {\n const { value } = opts;\n\n if (isScalar(value)) {\n return new Set([normalise(value)]);\n }\n\n if (Array.isArray(value)) {\n return value.every(isScalar)\n ? new Set(value.map(normalise))\n : 'a list with a non-scalar entry';\n }\n\n if (typeof value !== 'object' || value === undefined) {\n return 'an unsupported condition';\n }\n\n const operators = Object.keys(value as object);\n if (operators.length !== 1) {\n return `a condition with ${operators.length} operators cannot be checked on a write`;\n }\n\n const [operator] = operators;\n const operand = (value as Record<string, unknown>)[operator];\n\n if (operator === QueryOperators.EQ && isScalar(operand)) {\n return new Set([normalise(operand)]);\n }\n\n if (\n (operator === QueryOperators.INQ || operator === QueryOperators.IN) &&\n Array.isArray(operand)\n ) {\n return operand.every(isScalar)\n ? new Set(operand.map(normalise))\n : 'a list with a non-scalar entry';\n }\n\n return `the operator '${operator}' cannot be checked on a write`;\n }\n\n /**\n * Holds `rows` to the scope `settings.resolve()` returns now. Returns the rows to write: the same\n * objects when nothing changes, copies with the scope columns filled in for `assign`. Throws, and\n * so writes nothing, when any row is outside the scope.\n */\n static apply<Row extends Record<string, unknown>>(opts: {\n settings: IModelAccessSettings;\n model: string;\n rows: Row[];\n operation: 'create' | 'update';\n }): Row[] {\n const { settings, model, rows, operation } = opts;\n const scope = settings.resolve();\n\n if (scope === ScopeFilters.UNRESTRICTED) {\n return rows;\n }\n\n if (scope === null || scope === undefined) {\n // An update is already confined by the scoped `where`, which under `deny` matches no row; the\n // guard adds nothing there. A create has no such `where`, so an unresolved scope refuses it.\n if (settings.onMissing === ScopeFilterMissingBehaviors.ALLOW || operation === 'update') {\n return rows;\n }\n\n throw ScopeWriteGuard.denied({\n model,\n operation,\n detail: 'no scope could be resolved for this caller',\n });\n }\n\n const extraction = ScopeWriteGuard.extractConstraints({ where: scope });\n if (!extraction.isVerifiable) {\n throw ScopeWriteGuard.denied({\n model,\n operation,\n detail: `the resolved scope cannot be verified on a write | ${extraction.reason}`,\n });\n }\n\n const { constraints } = extraction;\n const declared = settings.columns;\n\n if (declared) {\n const undeclared = [...constraints.keys()].find((column) => !declared.includes(column));\n if (undeclared !== undefined) {\n throw ScopeWriteGuard.denied({\n model,\n operation,\n detail: `the resolved scope constrains column '${undeclared}', which access.columns does not declare`,\n });\n }\n }\n\n const isAssign = settings.write?.mode === ScopeWriteGuards.ASSIGN && operation === 'create';\n const sharedRows = settings.write?.sharedRows === true;\n\n return rows.map((row) => {\n let result = row;\n\n for (const [column, allowed] of constraints) {\n const value = (row as Record<string, unknown>)[column];\n\n if (value === undefined) {\n if (operation === 'update') {\n continue;\n }\n\n // `assign` first: stamping gives the row an owner, which is safer than leaving it shared.\n const only = allowed.size === 1 ? [...allowed][0] : undefined;\n if (isAssign && only !== undefined && only !== null) {\n result = { ...result, [column]: only };\n continue;\n }\n\n // Absent means the database default, usually `null`, so it is held to the `null` rule.\n if (sharedRows) {\n continue;\n }\n\n throw ScopeWriteGuard.denied({\n model,\n operation,\n column,\n detail: 'the scope column is missing',\n });\n }\n\n const normalised = isScalar(value) ? normalise(value) : undefined;\n // A `null` branch in the scope lets this caller READ shared rows. Writing one (or moving a\n // row into the shared set) is a separate permission: only `sharedRows` grants it.\n const isOutside = normalised === null ? !sharedRows : !allowed.has(normalised as string);\n\n if (normalised === undefined || isOutside) {\n throw ScopeWriteGuard.denied({\n model,\n operation,\n column,\n detail: 'the value is outside the resolved scope',\n });\n }\n }\n\n return result;\n });\n }\n\n /** Names the model and the column, never a value: the caller may be a request. */\n private static denied(opts: {\n model: string;\n operation: string;\n column?: string;\n detail: string;\n }) {\n const { model, operation, column, detail } = opts;\n\n return getError({\n statusCode: WRITE_DENIED_STATUS,\n messageCode: RepositoryErrorCodes.SCOPE_WRITE_DENIED,\n message: [\n `[${operation}] write refused by the access scope | entity: ${model}`,\n ...(column ? [`column: ${column}`] : []),\n detail,\n ].join(' | '),\n });\n }\n}\n"]}
@@ -1,4 +1,4 @@
1
- import type { IdType, IExtraOptions, IPersistableRepository, IScopeFilterSettings, ITransaction, TCount, TDataRange, TDrizzleQueryOptions, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TLockOptions, TRepositoryOperationScope, TWhere } from '@venizia/ignis-kernel';
1
+ import type { IdType, IExtraOptions, IPersistableRepository, IModelAccessSettings, ITransaction, TCount, TByIdFilter, TDataRange, TDrizzleQueryOptions, TFields, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TLockOptions, TRepositoryOperationScope, TRow, TWhere } from '@venizia/ignis-kernel';
2
2
  import { AbstractRepository } from '@venizia/ignis-kernel';
3
3
  import type { IRelationalDataSource } from '../../datasources/common/index.js';
4
4
  import type { BaseRelationalEntity, TTableInsert, TTableObject, TTableSchemaWithId } from '../../models/index.js';
@@ -45,10 +45,25 @@ export declare abstract class RelationalBaseRepository<EntitySchema extends TTab
45
45
  getDefaultFilter(): TFilter | undefined;
46
46
  getDefaultLimit(): number | undefined;
47
47
  hasDefaultFilter(): boolean;
48
- /** Same override seam as `getDefaultFilter()` - a repository with no resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid touching `modelSettings`/`entity` at all. */
49
- getScopeFilterSettings(): IScopeFilterSettings | undefined;
50
48
  /**
51
- * Row scope from `@model` settings.scopeFilter - AND-composed like a default filter, but never
49
+ * The model's `access` settings. Same override seam as `getDefaultFilter()` - a repository with no
50
+ * resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid
51
+ * touching `modelSettings`/`entity` at all. The name is kept from before `scopeFilter` became
52
+ * `access`, so an existing override keeps working.
53
+ */
54
+ getScopeFilterSettings(): IModelAccessSettings | undefined;
55
+ /**
56
+ * Holds written rows to the resolved row scope (`access.write`): refuses a row outside
57
+ * it, and for `assign` returns copies with the scope columns filled in. Nothing is written when it
58
+ * throws. Like the read scope, it is not skippable by `shouldSkipDefaultFilter`; a caller that is
59
+ * trusted to write across scopes resolves to `ScopeFilters.UNRESTRICTED`.
60
+ */
61
+ protected guardScopedWrite<Row extends Record<string, unknown>>(opts: {
62
+ rows: Row[];
63
+ operation: 'create' | 'update';
64
+ }): Row[];
65
+ /**
66
+ * Row scope from `@model` settings.access - AND-composed like a default filter, but never
52
67
  * skippable via `shouldSkipDefaultFilter`: that flag serves `restore()`'s deliberate reach past
53
68
  * soft-delete, which must not also reach past tenant/ownership scoping.
54
69
  *
@@ -109,26 +124,26 @@ export declare abstract class RelationalBaseRepository<EntitySchema extends TTab
109
124
  where: TWhere<DataObject>;
110
125
  options?: ExtraOptions;
111
126
  }): Promise<boolean>;
112
- abstract find<R = DataObject>(opts: {
113
- filter: TFilter<DataObject>;
114
- options: TFindRangeOptions<ExtraOptions, R>;
127
+ abstract find<R = unknown, const F extends TFields<DataObject> = TFields<DataObject>>(opts: {
128
+ filter: TFilter<DataObject, F>;
129
+ options: TFindRangeOptions<ExtraOptions, TRow<DataObject, R, F>>;
115
130
  }): Promise<{
116
- data: Array<R>;
131
+ data: Array<TRow<DataObject, R, F>>;
117
132
  range: TDataRange;
118
133
  }>;
119
- abstract find<R = DataObject>(opts: {
120
- filter: TFilter<DataObject>;
121
- options?: TFindOptions<ExtraOptions, R>;
122
- }): Promise<R[]>;
123
- abstract findOne<R = DataObject>(opts: {
124
- filter: TFilter<DataObject>;
125
- options?: TFindOneOptions<ExtraOptions, R>;
126
- }): Promise<TNullable<R>>;
127
- abstract findById<R = DataObject>(opts: {
134
+ abstract find<R = unknown, const F extends TFields<DataObject> = TFields<DataObject>>(opts: {
135
+ filter: TFilter<DataObject, F>;
136
+ options?: TFindOptions<ExtraOptions, TRow<DataObject, R, F>>;
137
+ }): Promise<Array<TRow<DataObject, R, F>>>;
138
+ abstract findOne<R = unknown, const F extends TFields<DataObject> = TFields<DataObject>>(opts: {
139
+ filter: TFilter<DataObject, F>;
140
+ options?: TFindOneOptions<ExtraOptions, TRow<DataObject, R, F>>;
141
+ }): Promise<TNullable<TRow<DataObject, R, F>>>;
142
+ abstract findById<R = unknown, const F extends TFields<DataObject> = TFields<DataObject>>(opts: {
128
143
  id: IdType;
129
- filter?: Omit<TFilter<DataObject>, 'where'>;
130
- options?: TFindOneOptions<ExtraOptions, R>;
131
- }): Promise<TNullable<R>>;
144
+ filter?: TByIdFilter<DataObject, F>;
145
+ options?: TFindOneOptions<ExtraOptions, TRow<DataObject, R, F>>;
146
+ }): Promise<TNullable<TRow<DataObject, R, F>>>;
132
147
  abstract create(opts: {
133
148
  data: PersistObject;
134
149
  options: ExtraOptions & {
@@ -1 +1 @@
1
- {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/core/base.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/core/base.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,7 @@ import { isTransactionCommitted } from '../../datasources/transaction-state.js';
4
4
  import { getError } from '@venizia/ignis-helpers/core';
5
5
  import { getTableColumns } from 'drizzle-orm';
6
6
  import { ScopeFilterDenial } from '../common/index.js';
7
+ import { ScopeWriteGuard } from '../common/scope-write-guard.js';
7
8
  /** Relational implementation of `AbstractRepository`: adds the query dialect + hidden-column exclusion on top of the neutral base, and reaches the database only through `IRelationalQueryExecutor`. Both engine-facing parameters default to the neutral SQL contracts; an engine binds them by subclassing. */
8
9
  export class RelationalBaseRepository extends AbstractRepository {
9
10
  /**
@@ -80,7 +81,7 @@ export class RelationalBaseRepository extends AbstractRepository {
80
81
  return this._visibleColumns;
81
82
  }
82
83
  getDefaultFilter() {
83
- return this.modelSettings?.defaultFilter;
84
+ return this.modelSettings?.query?.filter;
84
85
  }
85
86
  getDefaultLimit() {
86
87
  return this.defaultLimit;
@@ -89,12 +90,35 @@ export class RelationalBaseRepository extends AbstractRepository {
89
90
  const defaultFilter = this.getDefaultFilter();
90
91
  return defaultFilter !== undefined && Object.keys(defaultFilter).length > 0;
91
92
  }
92
- /** Same override seam as `getDefaultFilter()` - a repository with no resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid touching `modelSettings`/`entity` at all. */
93
+ /**
94
+ * The model's `access` settings. Same override seam as `getDefaultFilter()` - a repository with no
95
+ * resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid
96
+ * touching `modelSettings`/`entity` at all. The name is kept from before `scopeFilter` became
97
+ * `access`, so an existing override keeps working.
98
+ */
93
99
  getScopeFilterSettings() {
94
- return this.modelSettings?.scopeFilter;
100
+ return this.modelSettings?.access;
101
+ }
102
+ /**
103
+ * Holds written rows to the resolved row scope (`access.write`): refuses a row outside
104
+ * it, and for `assign` returns copies with the scope columns filled in. Nothing is written when it
105
+ * throws. Like the read scope, it is not skippable by `shouldSkipDefaultFilter`; a caller that is
106
+ * trusted to write across scopes resolves to `ScopeFilters.UNRESTRICTED`.
107
+ */
108
+ guardScopedWrite(opts) {
109
+ const settings = this.getScopeFilterSettings();
110
+ if (!settings) {
111
+ return opts.rows;
112
+ }
113
+ return ScopeWriteGuard.apply({
114
+ settings,
115
+ model: this.entity.name,
116
+ rows: opts.rows,
117
+ operation: opts.operation,
118
+ });
95
119
  }
96
120
  /**
97
- * Row scope from `@model` settings.scopeFilter - AND-composed like a default filter, but never
121
+ * Row scope from `@model` settings.access - AND-composed like a default filter, but never
98
122
  * skippable via `shouldSkipDefaultFilter`: that flag serves `restore()`'s deliberate reach past
99
123
  * soft-delete, which must not also reach past tenant/ownership scoping.
100
124
  *
@@ -221,6 +245,7 @@ export class RelationalBaseRepository extends AbstractRepository {
221
245
  const result = this.queryDialect.build({
222
246
  tableName: this.entity.name,
223
247
  schema: this.entity.schema,
248
+ // The dialect reads the filter against the table object; `DataObject` is the same row.
224
249
  filter: opts.filter,
225
250
  });
226
251
  if (!this.hasHiddenProperties()) {
@@ -1 +1 @@
1
- {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/core/base.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n IdType,\n IExtraOptions,\n IPersistableRepository,\n IScopeFilterSettings,\n ITransaction,\n TCount,\n TDataRange,\n TDrizzleQueryOptions,\n TFilter,\n TFindOneOptions,\n TFindOptions,\n TFindRangeOptions,\n TLockOptions,\n TRepositoryOperationScope,\n TWhere,\n} from '@venizia/ignis-kernel';\nimport {\n AbstractRepository,\n ScopeFilterMissingBehaviors,\n ScopeFilters,\n} from '@venizia/ignis-kernel';\n// Deep import, not the `@/relational/core/datasources` barrel: the barrel pulls the datasource classes, which import the engine branch's dialect and executor - an init cycle back into this tier.\nimport type { IRelationalDataSource } from '@/relational/core/datasources/common';\nimport { isRelationalTransaction } from '@/relational/core/datasources/common';\nimport { isTransactionCommitted } from '@/relational/core/datasources/transaction-state';\nimport type {\n BaseRelationalEntity,\n TTableInsert,\n TTableObject,\n TTableSchemaWithId,\n} from '@/relational/core/models';\nimport type { TClass, TNullable } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { getTableColumns } from 'drizzle-orm';\nimport type {\n IRelationalExtraOptions,\n IRelationalQueryDialect,\n IRelationalQueryExecutor,\n TRelationalConnectorOf,\n TRelationalTransactionOf,\n TRelationalTransactionOptionsOf,\n} from '../common';\nimport { ScopeFilterDenial } from '../common';\n\n/** Relational implementation of `AbstractRepository`: adds the query dialect + hidden-column exclusion on top of the neutral base, and reaches the database only through `IRelationalQueryExecutor`. Both engine-facing parameters default to the neutral SQL contracts; an engine binds them by subclassing. */\nexport abstract class RelationalBaseRepository<\n EntitySchema extends TTableSchemaWithId = TTableSchemaWithId,\n DataObject extends TTableObject<EntitySchema> = TTableObject<EntitySchema>,\n PersistObject extends TTableInsert<EntitySchema> = TTableInsert<EntitySchema>,\n ExtraOptions extends IExtraOptions = IRelationalExtraOptions,\n TDataSource extends IRelationalDataSource = IRelationalDataSource,\n>\n extends AbstractRepository<DataObject, PersistObject, ExtraOptions>\n implements IPersistableRepository<DataObject, PersistObject, ExtraOptions>\n{\n /**\n * The `Pick` return type is load-bearing, not decoration. `TWhere<DataObject>` is a homomorphic\n * mapped type over an unresolved type parameter, and TypeScript cannot check a one-key literal\n * against it - `{ id }` fails even though `id` is a real key. `Pick<..., 'id'>` resolves that one\n * key, and the result still assigns to `TWhere<DataObject>` because every key there is optional.\n * Without it every `*ById` method needs a cast, which would hide a genuinely wrong id type.\n */\n protected whereById(opts: { id: DataObject['id'] }): Pick<TWhere<DataObject>, 'id'> {\n return { id: opts.id };\n }\n\n /** Memoized Set view of the base's `hiddenFields` array - built once on first access. */\n private _hiddenPropertySet: Set<string> | null = null;\n\n /** Memoized Drizzle column-selection map derived from hidden fields. `null` = not yet computed; `undefined` = computed, no hidden fields. */\n private _visibleColumns: Record<string, unknown> | null | undefined = null;\n\n constructor(\n dataSource?: TDataSource,\n opts?: {\n scope?: string;\n entityClass?: TClass<BaseRelationalEntity<EntitySchema>>;\n operationScope?: TRepositoryOperationScope;\n },\n ) {\n super(dataSource, opts);\n }\n\n override get dataSource(): TDataSource {\n return super.dataSource as TDataSource;\n }\n\n override set dataSource(value: TDataSource) {\n super.dataSource = value;\n }\n\n override get entity(): BaseRelationalEntity<EntitySchema> {\n return super.entity as BaseRelationalEntity<EntitySchema>;\n }\n\n override set entity(value: BaseRelationalEntity<EntitySchema>) {\n super.entity = value;\n }\n\n get queryDialect(): IRelationalQueryDialect {\n return this.dataSource.getQueryDialect();\n }\n\n /** Every Drizzle call the repository tier makes goes through this port, supplied by the engine branch via the datasource. */\n protected get queryExecutor(): IRelationalQueryExecutor<TRelationalConnectorOf<TDataSource>> {\n return this.dataSource.getQueryExecutor() as IRelationalQueryExecutor<\n TRelationalConnectorOf<TDataSource>\n >;\n }\n\n get connector(): TRelationalConnectorOf<TDataSource> {\n return this.dataSource.getConnector() as TRelationalConnectorOf<TDataSource>;\n }\n\n override setDataSource(opts: { dataSource: TDataSource }): void {\n super.setDataSource(opts);\n }\n\n getEntitySchema(): EntitySchema {\n return this.entity.schema;\n }\n\n /** Hidden fields as a memoized Set, derived from the base's class-keyed `hiddenFields` array. */\n getHiddenProperties(): Set<string> {\n this._hiddenPropertySet ??= new Set(this.hiddenFields);\n return this._hiddenPropertySet;\n }\n\n hasHiddenProperties(): boolean {\n return this.getHiddenProperties().size > 0;\n }\n\n /** Drizzle select/returning column map excluding hidden properties. Undefined if none hidden. Memoized. */\n getVisibleProperties(): Record<string, any> | undefined {\n if (this._visibleColumns !== null) {\n return this._visibleColumns;\n }\n\n const hiddenProps = this.getHiddenProperties();\n\n if (hiddenProps.size === 0) {\n this._visibleColumns = undefined;\n return undefined;\n }\n\n const columns = getTableColumns(this.entity.schema);\n const visibleProperties: Record<string, any> = {};\n\n for (const key in columns) {\n if (!hiddenProps.has(key)) {\n visibleProperties[key] = columns[key];\n }\n }\n\n this._visibleColumns = visibleProperties;\n return this._visibleColumns;\n }\n\n getDefaultFilter(): TFilter | undefined {\n return this.modelSettings?.defaultFilter;\n }\n\n getDefaultLimit(): number | undefined {\n return this.defaultLimit;\n }\n\n hasDefaultFilter(): boolean {\n const defaultFilter = this.getDefaultFilter();\n return defaultFilter !== undefined && Object.keys(defaultFilter).length > 0;\n }\n\n /** Same override seam as `getDefaultFilter()` - a repository with no resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid touching `modelSettings`/`entity` at all. */\n getScopeFilterSettings(): IScopeFilterSettings | undefined {\n return this.modelSettings?.scopeFilter;\n }\n\n /**\n * Row scope from `@model` settings.scopeFilter - AND-composed like a default filter, but never\n * skippable via `shouldSkipDefaultFilter`: that flag serves `restore()`'s deliberate reach past\n * soft-delete, which must not also reach past tenant/ownership scoping.\n *\n * `dangerouslySkipScopeFilter` is framework-internal only, never part of `IExtraOptions` and never\n * wire-reachable: it exists so a filter this repository already scoped (find()'s own recursive\n * call) is not scoped a second time, and for explicitly-unscoped administrative code written and\n * reviewed at the repository - never inferable from a request.\n */\n protected applyScopeFilter<DO = any>(opts: {\n userFilter?: TFilter<DO>;\n dangerouslySkipScopeFilter?: boolean;\n }): TFilter<DO> {\n const { userFilter, dangerouslySkipScopeFilter } = opts;\n\n if (dangerouslySkipScopeFilter) {\n return userFilter ?? {};\n }\n\n const scopeFilterSettings = this.getScopeFilterSettings();\n if (!scopeFilterSettings) {\n return userFilter ?? {};\n }\n\n const scopeWhere = scopeFilterSettings.resolve();\n\n // Checked by exact symbol identity, before the null/undefined branch below: only this literal\n // value can skip scoping. A resolver that forgets a `return` on some branch produces\n // `undefined`, which is NOT this symbol and falls through to `onMissing` (deny by default).\n if (scopeWhere === ScopeFilters.UNRESTRICTED) {\n return userFilter ?? {};\n }\n\n if (scopeWhere !== null && scopeWhere !== undefined) {\n return this.queryDialect.mergeFilter({ defaultFilter: { where: scopeWhere }, userFilter });\n }\n\n if (scopeFilterSettings.onMissing === ScopeFilterMissingBehaviors.ALLOW) {\n return userFilter ?? {};\n }\n\n // 'deny' (default): an unresolved scope means the framework does not know what this caller may\n // see, and the safe reading of \"I do not know\" is \"nothing\" - never \"everything\".\n return this.queryDialect.mergeFilter({\n defaultFilter: { where: ScopeFilterDenial.where<DO>() },\n userFilter,\n });\n }\n\n /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter - the row scope from applyScopeFilter is not. */\n applyDefaultFilter<DO = any>(opts: {\n userFilter?: TFilter<DO>;\n shouldSkipDefaultFilter?: boolean;\n dangerouslySkipScopeFilter?: boolean;\n }): TFilter<DO> {\n const { userFilter, shouldSkipDefaultFilter, dangerouslySkipScopeFilter } = opts;\n\n const scopedFilter = this.applyScopeFilter<DO>({ userFilter, dangerouslySkipScopeFilter });\n\n if (shouldSkipDefaultFilter) {\n return scopedFilter;\n }\n\n const defaultFilter = this.getDefaultFilter();\n if (!defaultFilter) {\n return scopedFilter;\n }\n\n return this.queryDialect.mergeFilter({ defaultFilter, userFilter: scopedFilter });\n }\n\n async beginTransaction(\n opts?: TRelationalTransactionOptionsOf<TDataSource>,\n ): Promise<TRelationalTransactionOf<TDataSource>> {\n return this.dataSource.beginTransaction(opts) as Promise<TRelationalTransactionOf<TDataSource>>;\n }\n\n /**\n * Runs `execute` inside a transaction. Given a `transaction`, joins it: its owner commits or rolls\n * back, so this never does. Given none, owns one: begins it, commits when `execute` resolves, and\n * rolls back when `execute` or the commit throws - rethrowing the original error either way. An\n * owned transaction that `execute` already ended is never ended a second time.\n */\n async runInTransaction<ResultType>(opts: {\n transaction?: TRelationalTransactionOf<TDataSource>;\n transactionOptions?: TRelationalTransactionOptionsOf<TDataSource>;\n execute: (opts: { transaction: TRelationalTransactionOf<TDataSource> }) => Promise<ResultType>;\n }): Promise<ResultType> {\n const { transaction, transactionOptions, execute } = opts;\n\n if (transaction) {\n if (!transaction.isActive) {\n throw getError({\n message: `[${this.constructor.name}][runInTransaction] Transaction is no longer active`,\n });\n }\n\n if (transactionOptions) {\n this.logger\n .for('runInTransaction')\n .debug('Joined transaction | transactionOptions ignored: %j', transactionOptions);\n }\n\n return execute({ transaction });\n }\n\n const ownedTransaction = await this.beginTransaction(transactionOptions);\n\n let result: ResultType;\n try {\n result = await execute({ transaction: ownedTransaction });\n } catch (error) {\n if (ownedTransaction.isActive) {\n await this.rollbackOwnedTransaction({ transaction: ownedTransaction });\n }\n\n throw error;\n }\n\n if (!ownedTransaction.isActive) {\n return this.resolveEndedByExecute({ transaction: ownedTransaction, result });\n }\n\n try {\n await ownedTransaction.commit();\n } catch (error) {\n await this.rollbackOwnedTransaction({ transaction: ownedTransaction });\n throw error;\n }\n\n return result;\n }\n\n /** `execute` resolved after ending the owned transaction itself: its work stands only if it committed. */\n private resolveEndedByExecute<ResultType>(opts: {\n transaction: ITransaction;\n result: ResultType;\n }): ResultType {\n const { transaction, result } = opts;\n\n if (isTransactionCommitted({ transaction })) {\n this.logger\n .for('runInTransaction')\n .warn('execute committed the owned transaction itself | Skipped the commit');\n return result;\n }\n\n throw getError({\n message: `[${this.constructor.name}][runInTransaction] execute ended the owned transaction before it could be committed`,\n });\n }\n\n /** A rollback failure is only logged: the caller needs the error that made the rollback necessary. */\n private async rollbackOwnedTransaction(opts: { transaction: ITransaction }): Promise<void> {\n try {\n await opts.transaction.rollback();\n } catch (rollbackError) {\n this.logger\n .for('runInTransaction')\n .error(\n 'Rollback failed, rethrowing the original error | Rollback error: %s',\n rollbackError,\n );\n }\n }\n\n /** Builds Drizzle query options from a filter, excluding hidden properties. */\n buildQuery(opts: { filter: TFilter<DataObject> }): TDrizzleQueryOptions {\n const result = this.queryDialect.build({\n tableName: this.entity.name,\n schema: this.entity.schema,\n filter: opts.filter,\n });\n\n if (!this.hasHiddenProperties()) {\n return result;\n }\n\n const hiddenProps = this.getHiddenProperties();\n\n if (result.columns) {\n result.columns = this.omitHiddenColumns({ columns: result.columns, hiddenProps });\n return result;\n }\n\n const visibleProps = this.getVisibleProperties();\n if (visibleProps) {\n const filteredColumns: Record<string, boolean> = {};\n for (const key in visibleProps) {\n filteredColumns[key] = true;\n }\n result.columns = filteredColumns;\n }\n\n return result;\n }\n\n /** Copy of a Drizzle column selection with hidden properties dropped. */\n private omitHiddenColumns(opts: {\n columns: Record<string, boolean>;\n hiddenProps: Set<string>;\n }): Record<string, boolean> {\n const { columns, hiddenProps } = opts;\n const filteredColumns: Record<string, boolean> = {};\n\n for (const key in columns) {\n if (hiddenProps.has(key)) {\n continue;\n }\n\n filteredColumns[key] = columns[key];\n }\n\n return filteredColumns;\n }\n\n /** Resolves the database connector, using the transaction's connector if provided. */\n protected resolveConnector(opts?: {\n transaction?: ITransaction;\n }): TRelationalConnectorOf<TDataSource> {\n const { transaction } = opts ?? {};\n\n if (!transaction) {\n return this.dataSource.getConnector() as TRelationalConnectorOf<TDataSource>;\n }\n\n if (!transaction.isActive) {\n throw getError({\n message: `[${this.constructor.name}][resolveConnector] Transaction is no longer active`,\n });\n }\n\n if (!isRelationalTransaction(transaction)) {\n throw getError({\n message: `[${this.constructor.name}][resolveConnector] Transaction is not a relational transaction`,\n });\n }\n\n return transaction.connector as TRelationalConnectorOf<TDataSource>;\n }\n\n /** Validates lock options: requires transaction, incompatible with Query API (include/fields). */\n protected validateLockOptions(opts: {\n lock?: TLockOptions;\n transaction?: ITransaction;\n usesQueryAPI?: boolean;\n }): void {\n if (!opts.lock) {\n return;\n }\n\n if (!opts.transaction) {\n throw getError({\n message: `[${this.constructor.name}][validateLockOptions] Row-level locking requires a transaction`,\n });\n }\n\n if (opts.usesQueryAPI) {\n throw getError({\n message: `[${this.constructor.name}][validateLockOptions] Row-level locking is incompatible with Query API`,\n });\n }\n }\n\n abstract override count(opts: {\n where: TWhere<DataObject>;\n options?: ExtraOptions;\n }): Promise<TCount>;\n\n abstract override existsWith(opts: {\n where: TWhere<DataObject>;\n options?: ExtraOptions;\n }): Promise<boolean>;\n\n abstract override find<R = DataObject>(opts: {\n filter: TFilter<DataObject>;\n options: TFindRangeOptions<ExtraOptions, R>;\n }): Promise<{ data: Array<R>; range: TDataRange }>;\n\n abstract override find<R = DataObject>(opts: {\n filter: TFilter<DataObject>;\n options?: TFindOptions<ExtraOptions, R>;\n }): Promise<R[]>;\n\n abstract override findOne<R = DataObject>(opts: {\n filter: TFilter<DataObject>;\n options?: TFindOneOptions<ExtraOptions, R>;\n }): Promise<TNullable<R>>;\n\n abstract override findById<R = DataObject>(opts: {\n id: IdType;\n filter?: Omit<TFilter<DataObject>, 'where'>;\n options?: TFindOneOptions<ExtraOptions, R>;\n }): Promise<TNullable<R>>;\n\n abstract override create(opts: {\n data: PersistObject;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override create<R = DataObject>(opts: {\n data: PersistObject;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n\n abstract override createAll(opts: {\n data: Array<PersistObject>;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override createAll<R = DataObject>(opts: {\n data: Array<PersistObject>;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: Array<R> }>;\n\n abstract override updateById(opts: {\n id: IdType;\n data: Partial<PersistObject>;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override updateById<R = DataObject>(opts: {\n id: IdType;\n data: Partial<PersistObject>;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n\n abstract override updateAll(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override updateAll<R = DataObject>(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n\n // Re-declared, not inherited: the base alias is `Array<R> | null` to cover the search family, but SQL engines have RETURNING so this surface must stay exactly `Array<R>`.\n override updateBy(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n override updateBy<R = DataObject>(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n override updateBy<R = DataObject>(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: TNullable<Array<R>> }> {\n const { data, where, options } = opts;\n\n if (options?.shouldReturn === false) {\n return this.updateAll({ data, where, options: { ...options, shouldReturn: false } });\n }\n\n return this.updateAll<R>({ data, where, options });\n }\n\n abstract override deleteById(opts: {\n id: IdType;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override deleteById<R = DataObject>(opts: {\n id: IdType;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n\n abstract override deleteAll(opts: {\n where?: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override deleteAll<R = DataObject>(opts: {\n where?: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n\n // Same rationale as updateBy above: keep this alias surface at `Array<R>`.\n override deleteBy(opts: {\n where?: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n override deleteBy<R = DataObject>(opts: {\n where?: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n override deleteBy<R = DataObject>(opts: {\n where?: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: TNullable<Array<R>> }> {\n const { where, options } = opts;\n\n if (options?.shouldReturn === false) {\n return this.deleteAll({ where, options: { ...options, shouldReturn: false } });\n }\n\n return this.deleteAll<R>({ where, options });\n }\n}\n"]}
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/core/base.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n IdType,\n IExtraOptions,\n IPersistableRepository,\n IModelAccessSettings,\n ITransaction,\n TCount,\n TByIdFilter,\n TDataRange,\n TDrizzleQueryOptions,\n TFields,\n TFilter,\n TFindOneOptions,\n TFindOptions,\n TFindRangeOptions,\n TLockOptions,\n TRepositoryOperationScope,\n TRow,\n TWhere,\n} from '@venizia/ignis-kernel';\nimport {\n AbstractRepository,\n ScopeFilterMissingBehaviors,\n ScopeFilters,\n} from '@venizia/ignis-kernel';\n// Deep import, not the `@/relational/core/datasources` barrel: the barrel pulls the datasource classes, which import the engine branch's dialect and executor - an init cycle back into this tier.\nimport type { IRelationalDataSource } from '@/relational/core/datasources/common';\nimport { isRelationalTransaction } from '@/relational/core/datasources/common';\nimport { isTransactionCommitted } from '@/relational/core/datasources/transaction-state';\nimport type {\n BaseRelationalEntity,\n TTableInsert,\n TTableObject,\n TTableSchemaWithId,\n} from '@/relational/core/models';\nimport type { TClass, TNullable } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { getTableColumns } from 'drizzle-orm';\nimport type {\n IRelationalExtraOptions,\n IRelationalQueryDialect,\n IRelationalQueryExecutor,\n TRelationalConnectorOf,\n TRelationalTransactionOf,\n TRelationalTransactionOptionsOf,\n} from '../common';\nimport { ScopeFilterDenial } from '../common';\nimport { ScopeWriteGuard } from '../common/scope-write-guard';\n\n/** Relational implementation of `AbstractRepository`: adds the query dialect + hidden-column exclusion on top of the neutral base, and reaches the database only through `IRelationalQueryExecutor`. Both engine-facing parameters default to the neutral SQL contracts; an engine binds them by subclassing. */\nexport abstract class RelationalBaseRepository<\n EntitySchema extends TTableSchemaWithId = TTableSchemaWithId,\n DataObject extends TTableObject<EntitySchema> = TTableObject<EntitySchema>,\n PersistObject extends TTableInsert<EntitySchema> = TTableInsert<EntitySchema>,\n ExtraOptions extends IExtraOptions = IRelationalExtraOptions,\n TDataSource extends IRelationalDataSource = IRelationalDataSource,\n>\n extends AbstractRepository<DataObject, PersistObject, ExtraOptions>\n implements IPersistableRepository<DataObject, PersistObject, ExtraOptions>\n{\n /**\n * The `Pick` return type is load-bearing, not decoration. `TWhere<DataObject>` is a homomorphic\n * mapped type over an unresolved type parameter, and TypeScript cannot check a one-key literal\n * against it - `{ id }` fails even though `id` is a real key. `Pick<..., 'id'>` resolves that one\n * key, and the result still assigns to `TWhere<DataObject>` because every key there is optional.\n * Without it every `*ById` method needs a cast, which would hide a genuinely wrong id type.\n */\n protected whereById(opts: { id: DataObject['id'] }): Pick<TWhere<DataObject>, 'id'> {\n return { id: opts.id };\n }\n\n /** Memoized Set view of the base's `hiddenFields` array - built once on first access. */\n private _hiddenPropertySet: Set<string> | null = null;\n\n /** Memoized Drizzle column-selection map derived from hidden fields. `null` = not yet computed; `undefined` = computed, no hidden fields. */\n private _visibleColumns: Record<string, unknown> | null | undefined = null;\n\n constructor(\n dataSource?: TDataSource,\n opts?: {\n scope?: string;\n entityClass?: TClass<BaseRelationalEntity<EntitySchema>>;\n operationScope?: TRepositoryOperationScope;\n },\n ) {\n super(dataSource, opts);\n }\n\n override get dataSource(): TDataSource {\n return super.dataSource as TDataSource;\n }\n\n override set dataSource(value: TDataSource) {\n super.dataSource = value;\n }\n\n override get entity(): BaseRelationalEntity<EntitySchema> {\n return super.entity as BaseRelationalEntity<EntitySchema>;\n }\n\n override set entity(value: BaseRelationalEntity<EntitySchema>) {\n super.entity = value;\n }\n\n get queryDialect(): IRelationalQueryDialect {\n return this.dataSource.getQueryDialect();\n }\n\n /** Every Drizzle call the repository tier makes goes through this port, supplied by the engine branch via the datasource. */\n protected get queryExecutor(): IRelationalQueryExecutor<TRelationalConnectorOf<TDataSource>> {\n return this.dataSource.getQueryExecutor() as IRelationalQueryExecutor<\n TRelationalConnectorOf<TDataSource>\n >;\n }\n\n get connector(): TRelationalConnectorOf<TDataSource> {\n return this.dataSource.getConnector() as TRelationalConnectorOf<TDataSource>;\n }\n\n override setDataSource(opts: { dataSource: TDataSource }): void {\n super.setDataSource(opts);\n }\n\n getEntitySchema(): EntitySchema {\n return this.entity.schema;\n }\n\n /** Hidden fields as a memoized Set, derived from the base's class-keyed `hiddenFields` array. */\n getHiddenProperties(): Set<string> {\n this._hiddenPropertySet ??= new Set(this.hiddenFields);\n return this._hiddenPropertySet;\n }\n\n hasHiddenProperties(): boolean {\n return this.getHiddenProperties().size > 0;\n }\n\n /** Drizzle select/returning column map excluding hidden properties. Undefined if none hidden. Memoized. */\n getVisibleProperties(): Record<string, any> | undefined {\n if (this._visibleColumns !== null) {\n return this._visibleColumns;\n }\n\n const hiddenProps = this.getHiddenProperties();\n\n if (hiddenProps.size === 0) {\n this._visibleColumns = undefined;\n return undefined;\n }\n\n const columns = getTableColumns(this.entity.schema);\n const visibleProperties: Record<string, any> = {};\n\n for (const key in columns) {\n if (!hiddenProps.has(key)) {\n visibleProperties[key] = columns[key];\n }\n }\n\n this._visibleColumns = visibleProperties;\n return this._visibleColumns;\n }\n\n getDefaultFilter(): TFilter | undefined {\n return this.modelSettings?.query?.filter;\n }\n\n getDefaultLimit(): number | undefined {\n return this.defaultLimit;\n }\n\n hasDefaultFilter(): boolean {\n const defaultFilter = this.getDefaultFilter();\n return defaultFilter !== undefined && Object.keys(defaultFilter).length > 0;\n }\n\n /**\n * The model's `access` settings. Same override seam as `getDefaultFilter()` - a repository with no\n * resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid\n * touching `modelSettings`/`entity` at all. The name is kept from before `scopeFilter` became\n * `access`, so an existing override keeps working.\n */\n getScopeFilterSettings(): IModelAccessSettings | undefined {\n return this.modelSettings?.access;\n }\n\n /**\n * Holds written rows to the resolved row scope (`access.write`): refuses a row outside\n * it, and for `assign` returns copies with the scope columns filled in. Nothing is written when it\n * throws. Like the read scope, it is not skippable by `shouldSkipDefaultFilter`; a caller that is\n * trusted to write across scopes resolves to `ScopeFilters.UNRESTRICTED`.\n */\n protected guardScopedWrite<Row extends Record<string, unknown>>(opts: {\n rows: Row[];\n operation: 'create' | 'update';\n }): Row[] {\n const settings = this.getScopeFilterSettings();\n if (!settings) {\n return opts.rows;\n }\n\n return ScopeWriteGuard.apply({\n settings,\n model: this.entity.name,\n rows: opts.rows,\n operation: opts.operation,\n });\n }\n\n /**\n * Row scope from `@model` settings.access - AND-composed like a default filter, but never\n * skippable via `shouldSkipDefaultFilter`: that flag serves `restore()`'s deliberate reach past\n * soft-delete, which must not also reach past tenant/ownership scoping.\n *\n * `dangerouslySkipScopeFilter` is framework-internal only, never part of `IExtraOptions` and never\n * wire-reachable: it exists so a filter this repository already scoped (find()'s own recursive\n * call) is not scoped a second time, and for explicitly-unscoped administrative code written and\n * reviewed at the repository - never inferable from a request.\n */\n protected applyScopeFilter<DO = any>(opts: {\n userFilter?: TFilter<DO>;\n dangerouslySkipScopeFilter?: boolean;\n }): TFilter<DO> {\n const { userFilter, dangerouslySkipScopeFilter } = opts;\n\n if (dangerouslySkipScopeFilter) {\n return userFilter ?? {};\n }\n\n const scopeFilterSettings = this.getScopeFilterSettings();\n if (!scopeFilterSettings) {\n return userFilter ?? {};\n }\n\n const scopeWhere = scopeFilterSettings.resolve();\n\n // Checked by exact symbol identity, before the null/undefined branch below: only this literal\n // value can skip scoping. A resolver that forgets a `return` on some branch produces\n // `undefined`, which is NOT this symbol and falls through to `onMissing` (deny by default).\n if (scopeWhere === ScopeFilters.UNRESTRICTED) {\n return userFilter ?? {};\n }\n\n if (scopeWhere !== null && scopeWhere !== undefined) {\n return this.queryDialect.mergeFilter({ defaultFilter: { where: scopeWhere }, userFilter });\n }\n\n if (scopeFilterSettings.onMissing === ScopeFilterMissingBehaviors.ALLOW) {\n return userFilter ?? {};\n }\n\n // 'deny' (default): an unresolved scope means the framework does not know what this caller may\n // see, and the safe reading of \"I do not know\" is \"nothing\" - never \"everything\".\n return this.queryDialect.mergeFilter({\n defaultFilter: { where: ScopeFilterDenial.where<DO>() },\n userFilter,\n });\n }\n\n /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter - the row scope from applyScopeFilter is not. */\n applyDefaultFilter<DO = any>(opts: {\n userFilter?: TFilter<DO>;\n shouldSkipDefaultFilter?: boolean;\n dangerouslySkipScopeFilter?: boolean;\n }): TFilter<DO> {\n const { userFilter, shouldSkipDefaultFilter, dangerouslySkipScopeFilter } = opts;\n\n const scopedFilter = this.applyScopeFilter<DO>({ userFilter, dangerouslySkipScopeFilter });\n\n if (shouldSkipDefaultFilter) {\n return scopedFilter;\n }\n\n const defaultFilter = this.getDefaultFilter();\n if (!defaultFilter) {\n return scopedFilter;\n }\n\n return this.queryDialect.mergeFilter({ defaultFilter, userFilter: scopedFilter });\n }\n\n async beginTransaction(\n opts?: TRelationalTransactionOptionsOf<TDataSource>,\n ): Promise<TRelationalTransactionOf<TDataSource>> {\n return this.dataSource.beginTransaction(opts) as Promise<TRelationalTransactionOf<TDataSource>>;\n }\n\n /**\n * Runs `execute` inside a transaction. Given a `transaction`, joins it: its owner commits or rolls\n * back, so this never does. Given none, owns one: begins it, commits when `execute` resolves, and\n * rolls back when `execute` or the commit throws - rethrowing the original error either way. An\n * owned transaction that `execute` already ended is never ended a second time.\n */\n async runInTransaction<ResultType>(opts: {\n transaction?: TRelationalTransactionOf<TDataSource>;\n transactionOptions?: TRelationalTransactionOptionsOf<TDataSource>;\n execute: (opts: { transaction: TRelationalTransactionOf<TDataSource> }) => Promise<ResultType>;\n }): Promise<ResultType> {\n const { transaction, transactionOptions, execute } = opts;\n\n if (transaction) {\n if (!transaction.isActive) {\n throw getError({\n message: `[${this.constructor.name}][runInTransaction] Transaction is no longer active`,\n });\n }\n\n if (transactionOptions) {\n this.logger\n .for('runInTransaction')\n .debug('Joined transaction | transactionOptions ignored: %j', transactionOptions);\n }\n\n return execute({ transaction });\n }\n\n const ownedTransaction = await this.beginTransaction(transactionOptions);\n\n let result: ResultType;\n try {\n result = await execute({ transaction: ownedTransaction });\n } catch (error) {\n if (ownedTransaction.isActive) {\n await this.rollbackOwnedTransaction({ transaction: ownedTransaction });\n }\n\n throw error;\n }\n\n if (!ownedTransaction.isActive) {\n return this.resolveEndedByExecute({ transaction: ownedTransaction, result });\n }\n\n try {\n await ownedTransaction.commit();\n } catch (error) {\n await this.rollbackOwnedTransaction({ transaction: ownedTransaction });\n throw error;\n }\n\n return result;\n }\n\n /** `execute` resolved after ending the owned transaction itself: its work stands only if it committed. */\n private resolveEndedByExecute<ResultType>(opts: {\n transaction: ITransaction;\n result: ResultType;\n }): ResultType {\n const { transaction, result } = opts;\n\n if (isTransactionCommitted({ transaction })) {\n this.logger\n .for('runInTransaction')\n .warn('execute committed the owned transaction itself | Skipped the commit');\n return result;\n }\n\n throw getError({\n message: `[${this.constructor.name}][runInTransaction] execute ended the owned transaction before it could be committed`,\n });\n }\n\n /** A rollback failure is only logged: the caller needs the error that made the rollback necessary. */\n private async rollbackOwnedTransaction(opts: { transaction: ITransaction }): Promise<void> {\n try {\n await opts.transaction.rollback();\n } catch (rollbackError) {\n this.logger\n .for('runInTransaction')\n .error(\n 'Rollback failed, rethrowing the original error | Rollback error: %s',\n rollbackError,\n );\n }\n }\n\n /** Builds Drizzle query options from a filter, excluding hidden properties. */\n buildQuery(opts: { filter: TFilter<DataObject> }): TDrizzleQueryOptions {\n const result = this.queryDialect.build({\n tableName: this.entity.name,\n schema: this.entity.schema,\n // The dialect reads the filter against the table object; `DataObject` is the same row.\n filter: opts.filter as TFilter,\n });\n\n if (!this.hasHiddenProperties()) {\n return result;\n }\n\n const hiddenProps = this.getHiddenProperties();\n\n if (result.columns) {\n result.columns = this.omitHiddenColumns({ columns: result.columns, hiddenProps });\n return result;\n }\n\n const visibleProps = this.getVisibleProperties();\n if (visibleProps) {\n const filteredColumns: Record<string, boolean> = {};\n for (const key in visibleProps) {\n filteredColumns[key] = true;\n }\n result.columns = filteredColumns;\n }\n\n return result;\n }\n\n /** Copy of a Drizzle column selection with hidden properties dropped. */\n private omitHiddenColumns(opts: {\n columns: Record<string, boolean>;\n hiddenProps: Set<string>;\n }): Record<string, boolean> {\n const { columns, hiddenProps } = opts;\n const filteredColumns: Record<string, boolean> = {};\n\n for (const key in columns) {\n if (hiddenProps.has(key)) {\n continue;\n }\n\n filteredColumns[key] = columns[key];\n }\n\n return filteredColumns;\n }\n\n /** Resolves the database connector, using the transaction's connector if provided. */\n protected resolveConnector(opts?: {\n transaction?: ITransaction;\n }): TRelationalConnectorOf<TDataSource> {\n const { transaction } = opts ?? {};\n\n if (!transaction) {\n return this.dataSource.getConnector() as TRelationalConnectorOf<TDataSource>;\n }\n\n if (!transaction.isActive) {\n throw getError({\n message: `[${this.constructor.name}][resolveConnector] Transaction is no longer active`,\n });\n }\n\n if (!isRelationalTransaction(transaction)) {\n throw getError({\n message: `[${this.constructor.name}][resolveConnector] Transaction is not a relational transaction`,\n });\n }\n\n return transaction.connector as TRelationalConnectorOf<TDataSource>;\n }\n\n /** Validates lock options: requires transaction, incompatible with Query API (include/fields). */\n protected validateLockOptions(opts: {\n lock?: TLockOptions;\n transaction?: ITransaction;\n usesQueryAPI?: boolean;\n }): void {\n if (!opts.lock) {\n return;\n }\n\n if (!opts.transaction) {\n throw getError({\n message: `[${this.constructor.name}][validateLockOptions] Row-level locking requires a transaction`,\n });\n }\n\n if (opts.usesQueryAPI) {\n throw getError({\n message: `[${this.constructor.name}][validateLockOptions] Row-level locking is incompatible with Query API`,\n });\n }\n }\n\n abstract override count(opts: {\n where: TWhere<DataObject>;\n options?: ExtraOptions;\n }): Promise<TCount>;\n\n abstract override existsWith(opts: {\n where: TWhere<DataObject>;\n options?: ExtraOptions;\n }): Promise<boolean>;\n\n abstract override find<\n R = unknown,\n const F extends TFields<DataObject> = TFields<DataObject>,\n >(opts: {\n filter: TFilter<DataObject, F>;\n options: TFindRangeOptions<ExtraOptions, TRow<DataObject, R, F>>;\n }): Promise<{ data: Array<TRow<DataObject, R, F>>; range: TDataRange }>;\n\n abstract override find<\n R = unknown,\n const F extends TFields<DataObject> = TFields<DataObject>,\n >(opts: {\n filter: TFilter<DataObject, F>;\n options?: TFindOptions<ExtraOptions, TRow<DataObject, R, F>>;\n }): Promise<Array<TRow<DataObject, R, F>>>;\n\n abstract override findOne<\n R = unknown,\n const F extends TFields<DataObject> = TFields<DataObject>,\n >(opts: {\n filter: TFilter<DataObject, F>;\n options?: TFindOneOptions<ExtraOptions, TRow<DataObject, R, F>>;\n }): Promise<TNullable<TRow<DataObject, R, F>>>;\n\n abstract override findById<\n R = unknown,\n const F extends TFields<DataObject> = TFields<DataObject>,\n >(opts: {\n id: IdType;\n filter?: TByIdFilter<DataObject, F>;\n options?: TFindOneOptions<ExtraOptions, TRow<DataObject, R, F>>;\n }): Promise<TNullable<TRow<DataObject, R, F>>>;\n\n abstract override create(opts: {\n data: PersistObject;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override create<R = DataObject>(opts: {\n data: PersistObject;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n\n abstract override createAll(opts: {\n data: Array<PersistObject>;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override createAll<R = DataObject>(opts: {\n data: Array<PersistObject>;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: Array<R> }>;\n\n abstract override updateById(opts: {\n id: IdType;\n data: Partial<PersistObject>;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override updateById<R = DataObject>(opts: {\n id: IdType;\n data: Partial<PersistObject>;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n\n abstract override updateAll(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override updateAll<R = DataObject>(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n\n // Re-declared, not inherited: the base alias is `Array<R> | null` to cover the search family, but SQL engines have RETURNING so this surface must stay exactly `Array<R>`.\n override updateBy(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n override updateBy<R = DataObject>(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n override updateBy<R = DataObject>(opts: {\n data: Partial<PersistObject>;\n where: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: TNullable<Array<R>> }> {\n const { data, where, options } = opts;\n\n if (options?.shouldReturn === false) {\n return this.updateAll({ data, where, options: { ...options, shouldReturn: false } });\n }\n\n return this.updateAll<R>({ data, where, options });\n }\n\n abstract override deleteById(opts: {\n id: IdType;\n options: ExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override deleteById<R = DataObject>(opts: {\n id: IdType;\n options?: ExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n\n abstract override deleteAll(opts: {\n where?: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n\n abstract override deleteAll<R = DataObject>(opts: {\n where?: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n\n // Same rationale as updateBy above: keep this alias surface at `Array<R>`.\n override deleteBy(opts: {\n where?: TWhere<DataObject>;\n options: ExtraOptions & { shouldReturn: false; force?: boolean };\n }): Promise<TCount & { data: undefined | null }>;\n override deleteBy<R = DataObject>(opts: {\n where?: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: true; force?: boolean };\n }): Promise<TCount & { data: Array<R> }>;\n override deleteBy<R = DataObject>(opts: {\n where?: TWhere<DataObject>;\n options?: ExtraOptions & { shouldReturn?: boolean; force?: boolean };\n }): Promise<TCount & { data: TNullable<Array<R>> }> {\n const { where, options } = opts;\n\n if (options?.shouldReturn === false) {\n return this.deleteAll({ where, options: { ...options, shouldReturn: false } });\n }\n\n return this.deleteAll<R>({ where, options });\n }\n}\n"]}