@venizia/ignis-connectors 0.4.1 → 0.4.3

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 (170) hide show
  1. package/README.md +2 -2
  2. package/dist/cjs/common/scope-filter.d.ts +1 -1
  3. package/dist/cjs/common/scope-filter.d.ts.map +1 -1
  4. package/dist/cjs/common/scope-filter.js +33 -7
  5. package/dist/cjs/common/scope-filter.js.map +1 -1
  6. package/dist/cjs/http/common/constants.d.ts +11 -0
  7. package/dist/cjs/http/common/constants.d.ts.map +1 -0
  8. package/dist/cjs/http/common/constants.js +14 -0
  9. package/dist/cjs/http/common/constants.js.map +1 -0
  10. package/dist/cjs/http/common/wire.d.ts +2 -1
  11. package/dist/cjs/http/common/wire.d.ts.map +1 -1
  12. package/dist/cjs/http/common/wire.js +2 -1
  13. package/dist/cjs/http/common/wire.js.map +1 -1
  14. package/dist/cjs/http/datasource.d.ts +2 -1
  15. package/dist/cjs/http/datasource.d.ts.map +1 -1
  16. package/dist/cjs/http/datasource.js +2 -1
  17. package/dist/cjs/http/datasource.js.map +1 -1
  18. package/dist/cjs/http/index.d.ts +1 -0
  19. package/dist/cjs/http/index.d.ts.map +1 -1
  20. package/dist/cjs/http/index.js +1 -0
  21. package/dist/cjs/http/index.js.map +1 -1
  22. package/dist/cjs/http/repository.d.ts.map +1 -1
  23. package/dist/cjs/http/repository.js +5 -4
  24. package/dist/cjs/http/repository.js.map +1 -1
  25. package/dist/cjs/relational/core/repositories/common/constants.d.ts +11 -0
  26. package/dist/cjs/relational/core/repositories/common/constants.d.ts.map +1 -0
  27. package/dist/cjs/relational/core/repositories/common/constants.js +14 -0
  28. package/dist/cjs/relational/core/repositories/common/constants.js.map +1 -0
  29. package/dist/cjs/relational/core/repositories/common/index.d.ts +1 -0
  30. package/dist/cjs/relational/core/repositories/common/index.d.ts.map +1 -1
  31. package/dist/cjs/relational/core/repositories/common/index.js +1 -0
  32. package/dist/cjs/relational/core/repositories/common/index.js.map +1 -1
  33. package/dist/cjs/relational/core/repositories/common/scope-write-guard.d.ts +71 -0
  34. package/dist/cjs/relational/core/repositories/common/scope-write-guard.d.ts.map +1 -0
  35. package/dist/cjs/relational/core/repositories/common/scope-write-guard.js +377 -0
  36. package/dist/cjs/relational/core/repositories/common/scope-write-guard.js.map +1 -0
  37. package/dist/cjs/relational/core/repositories/core/base.d.ts +22 -4
  38. package/dist/cjs/relational/core/repositories/core/base.d.ts.map +1 -1
  39. package/dist/cjs/relational/core/repositories/core/base.js +49 -10
  40. package/dist/cjs/relational/core/repositories/core/base.js.map +1 -1
  41. package/dist/cjs/relational/core/repositories/core/persistable.d.ts.map +1 -1
  42. package/dist/cjs/relational/core/repositories/core/persistable.js +8 -1
  43. package/dist/cjs/relational/core/repositories/core/persistable.js.map +1 -1
  44. package/dist/cjs/relational/core/repositories/dialect/filter.d.ts +2 -2
  45. package/dist/cjs/relational/core/repositories/dialect/filter.js +3 -3
  46. package/dist/cjs/relational/core/repositories/dialect/filter.js.map +1 -1
  47. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts +9 -0
  48. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  49. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js +14 -3
  50. package/dist/cjs/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  51. package/dist/cjs/relational/postgres/models/common/constants.d.ts +11 -0
  52. package/dist/cjs/relational/postgres/models/common/constants.d.ts.map +1 -0
  53. package/dist/cjs/relational/postgres/models/common/constants.js +14 -0
  54. package/dist/cjs/relational/postgres/models/common/constants.js.map +1 -0
  55. package/dist/cjs/relational/postgres/models/common/index.d.ts +1 -0
  56. package/dist/cjs/relational/postgres/models/common/index.d.ts.map +1 -1
  57. package/dist/cjs/relational/postgres/models/common/index.js +1 -0
  58. package/dist/cjs/relational/postgres/models/common/index.js.map +1 -1
  59. package/dist/cjs/relational/postgres/models/common/types/enrichers.d.ts +5 -3
  60. package/dist/cjs/relational/postgres/models/common/types/enrichers.d.ts.map +1 -1
  61. package/dist/cjs/relational/postgres/models/common/types/enrichers.js.map +1 -1
  62. package/dist/cjs/relational/postgres/models/enrichers/principal.enricher.d.ts +4 -3
  63. package/dist/cjs/relational/postgres/models/enrichers/principal.enricher.d.ts.map +1 -1
  64. package/dist/cjs/relational/postgres/models/enrichers/principal.enricher.js.map +1 -1
  65. package/dist/cjs/relational/sqlite/models/common/types/enrichers.d.ts +3 -2
  66. package/dist/cjs/relational/sqlite/models/common/types/enrichers.d.ts.map +1 -1
  67. package/dist/cjs/relational/sqlite/models/common/types/enrichers.js.map +1 -1
  68. package/dist/cjs/relational/sqlite/models/enrichers/principal.enricher.d.ts +4 -3
  69. package/dist/cjs/relational/sqlite/models/enrichers/principal.enricher.d.ts.map +1 -1
  70. package/dist/cjs/relational/sqlite/models/enrichers/principal.enricher.js.map +1 -1
  71. package/dist/cjs/search/core/controllers/abstract.d.ts +4 -0
  72. package/dist/cjs/search/core/controllers/abstract.d.ts.map +1 -1
  73. package/dist/cjs/search/core/controllers/abstract.js +15 -1
  74. package/dist/cjs/search/core/controllers/abstract.js.map +1 -1
  75. package/dist/cjs/search/core/controllers/factory.d.ts +15 -1
  76. package/dist/cjs/search/core/controllers/factory.d.ts.map +1 -1
  77. package/dist/cjs/search/core/controllers/factory.js +7 -1
  78. package/dist/cjs/search/core/controllers/factory.js.map +1 -1
  79. package/dist/cjs/search/core/controllers/index.d.ts +1 -0
  80. package/dist/cjs/search/core/controllers/index.d.ts.map +1 -1
  81. package/dist/cjs/search/core/controllers/index.js.map +1 -1
  82. package/dist/cjs/search/core/controllers/scope.d.ts +28 -0
  83. package/dist/cjs/search/core/controllers/scope.d.ts.map +1 -0
  84. package/dist/cjs/search/core/controllers/scope.js +68 -0
  85. package/dist/cjs/search/core/controllers/scope.js.map +1 -0
  86. package/dist/esm/common/scope-filter.d.ts +1 -1
  87. package/dist/esm/common/scope-filter.d.ts.map +1 -1
  88. package/dist/esm/common/scope-filter.js +34 -8
  89. package/dist/esm/common/scope-filter.js.map +1 -1
  90. package/dist/esm/http/common/constants.d.ts +11 -0
  91. package/dist/esm/http/common/constants.d.ts.map +1 -0
  92. package/dist/esm/http/common/constants.js +10 -0
  93. package/dist/esm/http/common/constants.js.map +1 -0
  94. package/dist/esm/http/common/wire.d.ts +2 -1
  95. package/dist/esm/http/common/wire.d.ts.map +1 -1
  96. package/dist/esm/http/common/wire.js +2 -1
  97. package/dist/esm/http/common/wire.js.map +1 -1
  98. package/dist/esm/http/datasource.d.ts +2 -1
  99. package/dist/esm/http/datasource.d.ts.map +1 -1
  100. package/dist/esm/http/datasource.js +2 -1
  101. package/dist/esm/http/datasource.js.map +1 -1
  102. package/dist/esm/http/index.d.ts +1 -0
  103. package/dist/esm/http/index.d.ts.map +1 -1
  104. package/dist/esm/http/index.js +1 -0
  105. package/dist/esm/http/index.js.map +1 -1
  106. package/dist/esm/http/repository.d.ts.map +1 -1
  107. package/dist/esm/http/repository.js +5 -4
  108. package/dist/esm/http/repository.js.map +1 -1
  109. package/dist/esm/relational/core/repositories/common/constants.d.ts +11 -0
  110. package/dist/esm/relational/core/repositories/common/constants.d.ts.map +1 -0
  111. package/dist/esm/relational/core/repositories/common/constants.js +10 -0
  112. package/dist/esm/relational/core/repositories/common/constants.js.map +1 -0
  113. package/dist/esm/relational/core/repositories/common/index.d.ts +1 -0
  114. package/dist/esm/relational/core/repositories/common/index.d.ts.map +1 -1
  115. package/dist/esm/relational/core/repositories/common/index.js +1 -0
  116. package/dist/esm/relational/core/repositories/common/index.js.map +1 -1
  117. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts +71 -0
  118. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts.map +1 -0
  119. package/dist/esm/relational/core/repositories/common/scope-write-guard.js +373 -0
  120. package/dist/esm/relational/core/repositories/common/scope-write-guard.js.map +1 -0
  121. package/dist/esm/relational/core/repositories/core/base.d.ts +22 -4
  122. package/dist/esm/relational/core/repositories/core/base.d.ts.map +1 -1
  123. package/dist/esm/relational/core/repositories/core/base.js +49 -10
  124. package/dist/esm/relational/core/repositories/core/base.js.map +1 -1
  125. package/dist/esm/relational/core/repositories/core/persistable.d.ts.map +1 -1
  126. package/dist/esm/relational/core/repositories/core/persistable.js +8 -1
  127. package/dist/esm/relational/core/repositories/core/persistable.js.map +1 -1
  128. package/dist/esm/relational/core/repositories/dialect/filter.d.ts +2 -2
  129. package/dist/esm/relational/core/repositories/dialect/filter.js +3 -3
  130. package/dist/esm/relational/core/repositories/dialect/filter.js.map +1 -1
  131. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts +9 -0
  132. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts.map +1 -1
  133. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js +15 -4
  134. package/dist/esm/relational/core/repositories/sqls/recursive-tree.js.map +1 -1
  135. package/dist/esm/relational/postgres/models/common/constants.d.ts +11 -0
  136. package/dist/esm/relational/postgres/models/common/constants.d.ts.map +1 -0
  137. package/dist/esm/relational/postgres/models/common/constants.js +10 -0
  138. package/dist/esm/relational/postgres/models/common/constants.js.map +1 -0
  139. package/dist/esm/relational/postgres/models/common/index.d.ts +1 -0
  140. package/dist/esm/relational/postgres/models/common/index.d.ts.map +1 -1
  141. package/dist/esm/relational/postgres/models/common/index.js +1 -0
  142. package/dist/esm/relational/postgres/models/common/index.js.map +1 -1
  143. package/dist/esm/relational/postgres/models/common/types/enrichers.d.ts +5 -3
  144. package/dist/esm/relational/postgres/models/common/types/enrichers.d.ts.map +1 -1
  145. package/dist/esm/relational/postgres/models/common/types/enrichers.js.map +1 -1
  146. package/dist/esm/relational/postgres/models/enrichers/principal.enricher.d.ts +4 -3
  147. package/dist/esm/relational/postgres/models/enrichers/principal.enricher.d.ts.map +1 -1
  148. package/dist/esm/relational/postgres/models/enrichers/principal.enricher.js.map +1 -1
  149. package/dist/esm/relational/sqlite/models/common/types/enrichers.d.ts +3 -2
  150. package/dist/esm/relational/sqlite/models/common/types/enrichers.d.ts.map +1 -1
  151. package/dist/esm/relational/sqlite/models/common/types/enrichers.js.map +1 -1
  152. package/dist/esm/relational/sqlite/models/enrichers/principal.enricher.d.ts +4 -3
  153. package/dist/esm/relational/sqlite/models/enrichers/principal.enricher.d.ts.map +1 -1
  154. package/dist/esm/relational/sqlite/models/enrichers/principal.enricher.js.map +1 -1
  155. package/dist/esm/search/core/controllers/abstract.d.ts +4 -0
  156. package/dist/esm/search/core/controllers/abstract.d.ts.map +1 -1
  157. package/dist/esm/search/core/controllers/abstract.js +15 -1
  158. package/dist/esm/search/core/controllers/abstract.js.map +1 -1
  159. package/dist/esm/search/core/controllers/factory.d.ts +15 -1
  160. package/dist/esm/search/core/controllers/factory.d.ts.map +1 -1
  161. package/dist/esm/search/core/controllers/factory.js +7 -1
  162. package/dist/esm/search/core/controllers/factory.js.map +1 -1
  163. package/dist/esm/search/core/controllers/index.d.ts +1 -0
  164. package/dist/esm/search/core/controllers/index.d.ts.map +1 -1
  165. package/dist/esm/search/core/controllers/index.js.map +1 -1
  166. package/dist/esm/search/core/controllers/scope.d.ts +28 -0
  167. package/dist/esm/search/core/controllers/scope.d.ts.map +1 -0
  168. package/dist/esm/search/core/controllers/scope.js +64 -0
  169. package/dist/esm/search/core/controllers/scope.js.map +1 -0
  170. package/package.json +6 -6
@@ -0,0 +1,377 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ScopeWriteGuard = void 0;
4
+ const constants_1 = require("./constants");
5
+ const core_1 = require("@venizia/ignis-helpers/core");
6
+ const ignis_kernel_1 = require("@venizia/ignis-kernel");
7
+ const common_1 = require("@venizia/ignis-helpers/common");
8
+ const scope_filter_1 = require("./scope-filter");
9
+ const WRITE_DENIED_STATUS = common_1.HTTP.ResultCodes.RS_4.Forbidden;
10
+ const isScalar = (value) => {
11
+ return (value === null ||
12
+ value instanceof Date ||
13
+ ['string', 'number', 'bigint', 'boolean'].includes(typeof value));
14
+ };
15
+ const isRecord = (value) => {
16
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
17
+ };
18
+ const normalise = (value) => {
19
+ if (value === null) {
20
+ return null;
21
+ }
22
+ return value instanceof Date ? value.toISOString() : String(value);
23
+ };
24
+ const intersect = (opts) => {
25
+ return new Set([...opts.left].filter((value) => opts.right.has(value)));
26
+ };
27
+ /**
28
+ * The write side of `@model` settings.access. The resolved scope is a `where`; the guard reads
29
+ * from it the columns it constrains and the values it allows, and holds every written row to them.
30
+ *
31
+ * Only shapes that can be checked are read: a column equal to a scalar or `null`, `{ eq }`, `{ inq }`
32
+ * (or `in`), an array, `and` of those, and an `or` whose branches all constrain the same column. Anything
33
+ * else - an `or` over several columns, ranges, `like`, a nested path - makes
34
+ * the scope unverifiable, and the write is refused with its own message instead of being skipped.
35
+ */
36
+ class ScopeWriteGuard {
37
+ static extractConstraints(opts) {
38
+ const constraints = new Map();
39
+ const reason = ScopeWriteGuard.collect({
40
+ where: opts.where,
41
+ constraints,
42
+ });
43
+ return reason === undefined
44
+ ? { isVerifiable: true, constraints }
45
+ : { isVerifiable: false, reason };
46
+ }
47
+ /** Adds the where's constraints to `constraints`; returns the reason it cannot be verified, if any. */
48
+ static collect(opts) {
49
+ const { where, constraints } = opts;
50
+ for (const [key, value] of Object.entries(where)) {
51
+ if (key === 'and') {
52
+ if (!Array.isArray(value)) {
53
+ return "'and' is not a list";
54
+ }
55
+ for (const part of value) {
56
+ const reason = ScopeWriteGuard.collect({
57
+ where: part,
58
+ constraints,
59
+ });
60
+ if (reason !== undefined) {
61
+ return reason;
62
+ }
63
+ }
64
+ continue;
65
+ }
66
+ if (key === 'or') {
67
+ const union = ScopeWriteGuard.unionOfBranches({ branches: value });
68
+ if (typeof union === 'string') {
69
+ return union;
70
+ }
71
+ const existing = constraints.get(union.column);
72
+ constraints.set(union.column, existing ? intersect({ left: existing, right: union.allowed }) : union.allowed);
73
+ continue;
74
+ }
75
+ if (key.includes('.')) {
76
+ return `the nested path '${key}' cannot be checked on a write`;
77
+ }
78
+ const allowed = ScopeWriteGuard.allowedValues({ value });
79
+ if (typeof allowed === 'string') {
80
+ return `column '${key}': ${allowed}`;
81
+ }
82
+ const existing = constraints.get(key);
83
+ constraints.set(key, existing ? intersect({ left: existing, right: allowed }) : allowed);
84
+ }
85
+ return undefined;
86
+ }
87
+ /**
88
+ * An `or` is checkable only when every branch constrains the same single column with a scalar,
89
+ * `null`, `eq`, `in` or `inq`: the allowed values are then the union of the branches. This is the
90
+ * shared-rows scope, `{ or: [{ merchantId: { in: ids } }, { merchantId: null }] }`. Any other `or`
91
+ * (several columns, ranges, nested `and` or `or`) cannot be checked.
92
+ */
93
+ static unionOfBranches(opts) {
94
+ const { branches } = opts;
95
+ if (!Array.isArray(branches) || branches.length === 0) {
96
+ return "'or' is not a list";
97
+ }
98
+ let column;
99
+ const allowed = new Set();
100
+ for (const branch of branches) {
101
+ const entries = Object.entries((branch ?? {}));
102
+ if (entries.length !== 1) {
103
+ return "an 'or' branch with several conditions cannot be checked on a write";
104
+ }
105
+ const [key, value] = entries[0];
106
+ if (key === 'and' || key === 'or' || key.includes('.')) {
107
+ return `an 'or' branch over '${key}' cannot be checked on a write`;
108
+ }
109
+ if (column !== undefined && column !== key) {
110
+ return "an 'or' over different columns cannot be checked on a write";
111
+ }
112
+ column = key;
113
+ const values = ScopeWriteGuard.allowedValues({ value });
114
+ if (typeof values === 'string') {
115
+ return `column '${key}': ${values}`;
116
+ }
117
+ values.forEach((entry) => allowed.add(entry));
118
+ }
119
+ return { column: column, allowed };
120
+ }
121
+ /** The values one column's condition allows, or a string naming why it cannot be checked. */
122
+ static allowedValues(opts) {
123
+ const { value } = opts;
124
+ if (isScalar(value)) {
125
+ return new Set([normalise(value)]);
126
+ }
127
+ if (Array.isArray(value)) {
128
+ return value.every(isScalar)
129
+ ? new Set(value.map(normalise))
130
+ : 'a list with a non-scalar entry';
131
+ }
132
+ if (typeof value !== 'object' || value === undefined) {
133
+ return 'an unsupported condition';
134
+ }
135
+ const operators = Object.keys(value);
136
+ if (operators.length !== 1) {
137
+ return `a condition with ${operators.length} operators cannot be checked on a write`;
138
+ }
139
+ const [operator] = operators;
140
+ const operand = value[operator];
141
+ if (operator === ignis_kernel_1.QueryOperators.EQ && isScalar(operand)) {
142
+ return new Set([normalise(operand)]);
143
+ }
144
+ if ((operator === ignis_kernel_1.QueryOperators.INQ || operator === ignis_kernel_1.QueryOperators.IN) &&
145
+ Array.isArray(operand)) {
146
+ return operand.every(isScalar)
147
+ ? new Set(operand.map(normalise))
148
+ : 'a list with a non-scalar entry';
149
+ }
150
+ return `the operator '${operator}' cannot be checked on a write`;
151
+ }
152
+ /**
153
+ * The scope as a MUTATION `where` (update, delete, soft delete, restore). A scope with a `null`
154
+ * branch - `{ or: [{ merchantId: { in: ids } }, { merchantId: null }] }` - lets the caller READ the
155
+ * shared rows. Changing or deleting one is the same permission as creating one, `write.sharedRows`,
156
+ * so without it the `null` branch is removed and only the caller's own rows match. With
157
+ * `sharedRows` the scope is returned as it is.
158
+ *
159
+ * Only the shapes the write guard can read are narrowed. Any other shape cannot be shown to exclude
160
+ * the shared rows, so the mutation is refused, as an update with a payload already is.
161
+ */
162
+ static mutationWhere(opts) {
163
+ const { settings, model, operation, scopeWhere } = opts;
164
+ if (settings.write?.sharedRows === true) {
165
+ return scopeWhere;
166
+ }
167
+ const narrowed = ScopeWriteGuard.withoutShared({ where: scopeWhere });
168
+ if (narrowed.kind === 'unverifiable') {
169
+ throw ScopeWriteGuard.denied({
170
+ model,
171
+ operation,
172
+ detail: `the resolved scope cannot be verified on a write | ${narrowed.reason}`,
173
+ });
174
+ }
175
+ return narrowed.kind === 'none' ? scope_filter_1.ScopeFilterDenial.where() : narrowed.where;
176
+ }
177
+ /** `where` with every `null` the scope allows removed; `none` when nothing but `null` was allowed. */
178
+ static withoutShared(opts) {
179
+ const result = {};
180
+ for (const [key, value] of Object.entries(opts.where)) {
181
+ if (key === 'and' || key === 'or') {
182
+ if (!Array.isArray(value) || (key === 'or' && value.length === 0)) {
183
+ return { kind: 'unverifiable', reason: `'${key}' is not a list` };
184
+ }
185
+ // An 'or' is read only when every branch constrains the same column, as the guard reads it: a branch over another column
186
+ // could match a shared row without a null in sight.
187
+ if (key === 'or') {
188
+ const union = ScopeWriteGuard.unionOfBranches({ branches: value });
189
+ if (typeof union === 'string') {
190
+ return { kind: 'unverifiable', reason: union };
191
+ }
192
+ }
193
+ const kept = [];
194
+ for (const part of value) {
195
+ const narrowed = ScopeWriteGuard.withoutShared({ where: isRecord(part) ? part : {} });
196
+ if (narrowed.kind === 'unverifiable') {
197
+ return narrowed;
198
+ }
199
+ if (narrowed.kind === 'none') {
200
+ // One impossible 'and' part makes the whole 'and' impossible; an impossible 'or' branch just drops out.
201
+ if (key === 'and') {
202
+ return narrowed;
203
+ }
204
+ continue;
205
+ }
206
+ kept.push(narrowed.where);
207
+ }
208
+ if (key === 'or' && kept.length === 0) {
209
+ return { kind: 'none' };
210
+ }
211
+ result[key] = kept;
212
+ continue;
213
+ }
214
+ if (key.includes('.')) {
215
+ return {
216
+ kind: 'unverifiable',
217
+ reason: `the nested path '${key}' cannot be checked on a write`,
218
+ };
219
+ }
220
+ const narrowed = ScopeWriteGuard.conditionWithoutNull({ value });
221
+ if (narrowed.kind !== 'condition') {
222
+ return narrowed.kind === 'none'
223
+ ? { kind: 'none' }
224
+ : { kind: 'unverifiable', reason: `column '${key}': ${narrowed.reason}` };
225
+ }
226
+ result[key] = narrowed.value;
227
+ }
228
+ return { kind: 'where', where: result };
229
+ }
230
+ /** One column's condition without its `null` values, reading the same shapes `allowedValues` reads. */
231
+ static conditionWithoutNull(opts) {
232
+ const { value } = opts;
233
+ const list = (entries) => {
234
+ if (!entries.every(isScalar)) {
235
+ return { kind: 'unverifiable', reason: 'a list with a non-scalar entry' };
236
+ }
237
+ const kept = entries.filter((entry) => entry !== null);
238
+ return kept.length === 0
239
+ ? { kind: 'none' }
240
+ : { kind: 'condition', value: kept };
241
+ };
242
+ if (isScalar(value)) {
243
+ return value === null ? { kind: 'none' } : { kind: 'condition', value };
244
+ }
245
+ if (Array.isArray(value)) {
246
+ return list(value);
247
+ }
248
+ if (!isRecord(value)) {
249
+ return { kind: 'unverifiable', reason: 'an unsupported condition' };
250
+ }
251
+ const operators = Object.keys(value);
252
+ if (operators.length !== 1) {
253
+ return {
254
+ kind: 'unverifiable',
255
+ reason: `a condition with ${operators.length} operators cannot be checked on a write`,
256
+ };
257
+ }
258
+ const [operator] = operators;
259
+ const operand = value[operator];
260
+ if (operator === ignis_kernel_1.QueryOperators.EQ && isScalar(operand)) {
261
+ return operand === null ? { kind: 'none' } : { kind: 'condition', value };
262
+ }
263
+ if ((operator === ignis_kernel_1.QueryOperators.INQ || operator === ignis_kernel_1.QueryOperators.IN) &&
264
+ Array.isArray(operand)) {
265
+ const narrowed = list(operand);
266
+ return narrowed.kind === 'condition'
267
+ ? { kind: 'condition', value: { [operator]: narrowed.value } }
268
+ : narrowed;
269
+ }
270
+ return {
271
+ kind: 'unverifiable',
272
+ reason: `the operator '${operator}' cannot be checked on a write`,
273
+ };
274
+ }
275
+ /**
276
+ * Holds `rows` to the scope `settings.resolve()` returns now. Returns the rows to write: the same
277
+ * objects when nothing changes, copies with the scope columns filled in for `assign`. Throws, and
278
+ * so writes nothing, when any row is outside the scope.
279
+ */
280
+ static apply(opts) {
281
+ const { settings, model, rows, operation } = opts;
282
+ const scope = settings.resolve();
283
+ if (scope === ignis_kernel_1.ScopeFilters.UNRESTRICTED) {
284
+ return rows;
285
+ }
286
+ if (scope === null || scope === undefined) {
287
+ // An update is already confined by the scoped `where`, which under `deny` matches no row; the
288
+ // guard adds nothing there. A create has no such `where`, so an unresolved scope refuses it.
289
+ if (settings.onMissing === ignis_kernel_1.ScopeFilterMissingBehaviors.ALLOW ||
290
+ operation === constants_1.ScopeWriteOperations.UPDATE) {
291
+ return rows;
292
+ }
293
+ throw ScopeWriteGuard.denied({
294
+ model,
295
+ operation,
296
+ detail: 'no scope could be resolved for this caller',
297
+ });
298
+ }
299
+ const extraction = ScopeWriteGuard.extractConstraints({ where: scope });
300
+ if (!extraction.isVerifiable) {
301
+ throw ScopeWriteGuard.denied({
302
+ model,
303
+ operation,
304
+ detail: `the resolved scope cannot be verified on a write | ${extraction.reason}`,
305
+ });
306
+ }
307
+ const { constraints } = extraction;
308
+ const declared = settings.columns;
309
+ if (declared) {
310
+ const undeclared = [...constraints.keys()].find((column) => !declared.includes(column));
311
+ if (undeclared !== undefined) {
312
+ throw ScopeWriteGuard.denied({
313
+ model,
314
+ operation,
315
+ detail: `the resolved scope constrains column '${undeclared}', which access.columns does not declare`,
316
+ });
317
+ }
318
+ }
319
+ const isAssign = settings.write?.mode === ignis_kernel_1.ScopeWriteGuards.ASSIGN && operation === 'create';
320
+ const sharedRows = settings.write?.sharedRows === true;
321
+ return rows.map((row) => {
322
+ let result = row;
323
+ for (const [column, allowed] of constraints) {
324
+ const value = row[column];
325
+ if (value === undefined) {
326
+ if (operation === 'update') {
327
+ continue;
328
+ }
329
+ // `assign` first: stamping gives the row an owner, which is safer than leaving it shared.
330
+ const only = allowed.size === 1 ? [...allowed][0] : undefined;
331
+ if (isAssign && only !== undefined && only !== null) {
332
+ result = { ...result, [column]: only };
333
+ continue;
334
+ }
335
+ // Absent means the database default, usually `null`, so it is held to the `null` rule.
336
+ if (sharedRows) {
337
+ continue;
338
+ }
339
+ throw ScopeWriteGuard.denied({
340
+ model,
341
+ operation,
342
+ column,
343
+ detail: 'the scope column is missing',
344
+ });
345
+ }
346
+ const normalised = isScalar(value) ? normalise(value) : undefined;
347
+ // A `null` branch in the scope lets this caller READ shared rows. Writing one (or moving a
348
+ // row into the shared set) is a separate permission: only `sharedRows` grants it.
349
+ const isOutside = normalised === null ? !sharedRows : !allowed.has(normalised);
350
+ if (normalised === undefined || isOutside) {
351
+ throw ScopeWriteGuard.denied({
352
+ model,
353
+ operation,
354
+ column,
355
+ detail: 'the value is outside the resolved scope',
356
+ });
357
+ }
358
+ }
359
+ return result;
360
+ });
361
+ }
362
+ /** Names the model and the column, never a value: the caller may be a request. */
363
+ static denied(opts) {
364
+ const { model, operation, column, detail } = opts;
365
+ return (0, core_1.getError)({
366
+ statusCode: WRITE_DENIED_STATUS,
367
+ messageCode: ignis_kernel_1.RepositoryErrorCodes.SCOPE_WRITE_DENIED,
368
+ message: [
369
+ `[${operation}] write refused by the access scope | entity: ${model}`,
370
+ ...(column ? [`column: ${column}`] : []),
371
+ detail,
372
+ ].join(' | '),
373
+ });
374
+ }
375
+ }
376
+ exports.ScopeWriteGuard = ScopeWriteGuard;
377
+ //# 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 { ScopeWriteOperations, type TScopeWriteOperation } from './constants';\nimport { 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';\nimport { ScopeFilterDenial } from './scope-filter';\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\n/** What the scope becomes for a write: a `where`, no row at all, or a shape that cannot be narrowed. */\ntype TNarrowed =\n | { kind: 'where'; where: TWhere }\n | { kind: 'none' }\n | { kind: 'unverifiable'; 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 isRecord = (value: unknown): value is Record<string, unknown> => {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\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 * The scope as a MUTATION `where` (update, delete, soft delete, restore). A scope with a `null`\n * branch - `{ or: [{ merchantId: { in: ids } }, { merchantId: null }] }` - lets the caller READ the\n * shared rows. Changing or deleting one is the same permission as creating one, `write.sharedRows`,\n * so without it the `null` branch is removed and only the caller's own rows match. With\n * `sharedRows` the scope is returned as it is.\n *\n * Only the shapes the write guard can read are narrowed. Any other shape cannot be shown to exclude\n * the shared rows, so the mutation is refused, as an update with a payload already is.\n */\n static mutationWhere(opts: {\n settings: IModelAccessSettings;\n model: string;\n operation: string;\n scopeWhere: TWhere;\n }): TWhere {\n const { settings, model, operation, scopeWhere } = opts;\n\n if (settings.write?.sharedRows === true) {\n return scopeWhere;\n }\n\n const narrowed = ScopeWriteGuard.withoutShared({ where: scopeWhere });\n\n if (narrowed.kind === 'unverifiable') {\n throw ScopeWriteGuard.denied({\n model,\n operation,\n detail: `the resolved scope cannot be verified on a write | ${narrowed.reason}`,\n });\n }\n\n return narrowed.kind === 'none' ? ScopeFilterDenial.where() : narrowed.where;\n }\n\n /** `where` with every `null` the scope allows removed; `none` when nothing but `null` was allowed. */\n private static withoutShared(opts: { where: TWhere }): TNarrowed {\n const result: TWhere = {};\n\n for (const [key, value] of Object.entries(opts.where)) {\n if (key === 'and' || key === 'or') {\n if (!Array.isArray(value) || (key === 'or' && value.length === 0)) {\n return { kind: 'unverifiable', reason: `'${key}' is not a list` };\n }\n\n // An 'or' is read only when every branch constrains the same column, as the guard reads it: a branch over another column\n // could match a shared row without a null in sight.\n if (key === 'or') {\n const union = ScopeWriteGuard.unionOfBranches({ branches: value });\n if (typeof union === 'string') {\n return { kind: 'unverifiable', reason: union };\n }\n }\n\n const kept: TWhere[] = [];\n for (const part of value) {\n const narrowed = ScopeWriteGuard.withoutShared({ where: isRecord(part) ? part : {} });\n\n if (narrowed.kind === 'unverifiable') {\n return narrowed;\n }\n\n if (narrowed.kind === 'none') {\n // One impossible 'and' part makes the whole 'and' impossible; an impossible 'or' branch just drops out.\n if (key === 'and') {\n return narrowed;\n }\n continue;\n }\n\n kept.push(narrowed.where);\n }\n\n if (key === 'or' && kept.length === 0) {\n return { kind: 'none' };\n }\n\n result[key] = kept;\n continue;\n }\n\n if (key.includes('.')) {\n return {\n kind: 'unverifiable',\n reason: `the nested path '${key}' cannot be checked on a write`,\n };\n }\n\n const narrowed = ScopeWriteGuard.conditionWithoutNull({ value });\n if (narrowed.kind !== 'condition') {\n return narrowed.kind === 'none'\n ? { kind: 'none' }\n : { kind: 'unverifiable', reason: `column '${key}': ${narrowed.reason}` };\n }\n\n result[key] = narrowed.value;\n }\n\n return { kind: 'where', where: result };\n }\n\n /** One column's condition without its `null` values, reading the same shapes `allowedValues` reads. */\n private static conditionWithoutNull(opts: {\n value: unknown;\n }):\n | { kind: 'condition'; value: unknown }\n | { kind: 'none' }\n | { kind: 'unverifiable'; reason: string } {\n const { value } = opts;\n\n const list = (entries: unknown[]) => {\n if (!entries.every(isScalar)) {\n return { kind: 'unverifiable' as const, reason: 'a list with a non-scalar entry' };\n }\n\n const kept = entries.filter((entry) => entry !== null);\n return kept.length === 0\n ? { kind: 'none' as const }\n : { kind: 'condition' as const, value: kept };\n };\n\n if (isScalar(value)) {\n return value === null ? { kind: 'none' } : { kind: 'condition', value };\n }\n\n if (Array.isArray(value)) {\n return list(value);\n }\n\n if (!isRecord(value)) {\n return { kind: 'unverifiable', reason: 'an unsupported condition' };\n }\n\n const operators = Object.keys(value);\n if (operators.length !== 1) {\n return {\n kind: 'unverifiable',\n reason: `a condition with ${operators.length} operators cannot be checked on a write`,\n };\n }\n\n const [operator] = operators;\n const operand = value[operator];\n\n if (operator === QueryOperators.EQ && isScalar(operand)) {\n return operand === null ? { kind: 'none' } : { kind: 'condition', value };\n }\n\n if (\n (operator === QueryOperators.INQ || operator === QueryOperators.IN) &&\n Array.isArray(operand)\n ) {\n const narrowed = list(operand);\n return narrowed.kind === 'condition'\n ? { kind: 'condition', value: { [operator]: narrowed.value } }\n : narrowed;\n }\n\n return {\n kind: 'unverifiable',\n reason: `the operator '${operator}' cannot be checked on a write`,\n };\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: TScopeWriteOperation;\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 (\n settings.onMissing === ScopeFilterMissingBehaviors.ALLOW ||\n operation === ScopeWriteOperations.UPDATE\n ) {\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,5 @@
1
- import type { IdType, IExtraOptions, IPersistableRepository, IScopeFilterSettings, ITransaction, TCount, TByIdFilter, TDataRange, TDrizzleQueryOptions, TFields, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TLockOptions, TRepositoryOperationScope, TRow, TWhere } from '@venizia/ignis-kernel';
1
+ import type { TScopeWriteOperation } from '../common/constants';
2
+ 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
3
  import { AbstractRepository } from '@venizia/ignis-kernel';
3
4
  import type { IRelationalDataSource } from '../../datasources/common';
4
5
  import type { BaseRelationalEntity, TTableInsert, TTableObject, TTableSchemaWithId } from '../../models';
@@ -45,10 +46,24 @@ export declare abstract class RelationalBaseRepository<EntitySchema extends TTab
45
46
  getDefaultFilter(): TFilter | undefined;
46
47
  getDefaultLimit(): number | undefined;
47
48
  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
49
  /**
51
- * Row scope from `@model` settings.scopeFilter - AND-composed like a default filter, but never
50
+ * The model's `access` settings. Same override seam as `getDefaultFilter()` - a repository with no
51
+ * resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid
52
+ * touching `modelSettings`/`entity` at all.
53
+ */
54
+ getAccessSettings(): 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: TScopeWriteOperation;
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
  *
@@ -60,12 +75,15 @@ export declare abstract class RelationalBaseRepository<EntitySchema extends TTab
60
75
  protected applyScopeFilter<DO = any>(opts: {
61
76
  userFilter?: TFilter<DO>;
62
77
  dangerouslySkipScopeFilter?: boolean;
78
+ mutation?: string;
63
79
  }): TFilter<DO>;
64
80
  /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter - the row scope from applyScopeFilter is not. */
65
81
  applyDefaultFilter<DO = any>(opts: {
66
82
  userFilter?: TFilter<DO>;
67
83
  shouldSkipDefaultFilter?: boolean;
68
84
  dangerouslySkipScopeFilter?: boolean;
85
+ /** The name of the write (`update`, `delete`) when the filter selects rows to change: the row scope then leaves out the shared rows unless `write.sharedRows`. */
86
+ mutation?: string;
69
87
  }): TFilter<DO>;
70
88
  beginTransaction(opts?: TRelationalTransactionOptionsOf<TDataSource>): Promise<TRelationalTransactionOf<TDataSource>>;
71
89
  /**
@@ -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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"}
@@ -7,6 +7,7 @@ const transaction_state_1 = require("../../datasources/transaction-state");
7
7
  const core_1 = require("@venizia/ignis-helpers/core");
8
8
  const drizzle_orm_1 = require("drizzle-orm");
9
9
  const common_2 = require("../common");
10
+ const scope_write_guard_1 = require("../common/scope-write-guard");
10
11
  /** 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. */
11
12
  class RelationalBaseRepository extends ignis_kernel_1.AbstractRepository {
12
13
  /**
@@ -83,7 +84,7 @@ class RelationalBaseRepository extends ignis_kernel_1.AbstractRepository {
83
84
  return this._visibleColumns;
84
85
  }
85
86
  getDefaultFilter() {
86
- return this.modelSettings?.defaultFilter;
87
+ return this.modelSettings?.query?.filter;
87
88
  }
88
89
  getDefaultLimit() {
89
90
  return this.defaultLimit;
@@ -92,12 +93,34 @@ class RelationalBaseRepository extends ignis_kernel_1.AbstractRepository {
92
93
  const defaultFilter = this.getDefaultFilter();
93
94
  return defaultFilter !== undefined && Object.keys(defaultFilter).length > 0;
94
95
  }
95
- /** 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. */
96
- getScopeFilterSettings() {
97
- return this.modelSettings?.scopeFilter;
96
+ /**
97
+ * The model's `access` settings. Same override seam as `getDefaultFilter()` - a repository with no
98
+ * resolvable `@model` entity (a synthetic test double, a hand-built stub) overrides this to avoid
99
+ * touching `modelSettings`/`entity` at all.
100
+ */
101
+ getAccessSettings() {
102
+ return this.modelSettings?.access;
98
103
  }
99
104
  /**
100
- * Row scope from `@model` settings.scopeFilter - AND-composed like a default filter, but never
105
+ * Holds written rows to the resolved row scope (`access.write`): refuses a row outside
106
+ * it, and for `assign` returns copies with the scope columns filled in. Nothing is written when it
107
+ * throws. Like the read scope, it is not skippable by `shouldSkipDefaultFilter`; a caller that is
108
+ * trusted to write across scopes resolves to `ScopeFilters.UNRESTRICTED`.
109
+ */
110
+ guardScopedWrite(opts) {
111
+ const settings = this.getAccessSettings();
112
+ if (!settings) {
113
+ return opts.rows;
114
+ }
115
+ return scope_write_guard_1.ScopeWriteGuard.apply({
116
+ settings,
117
+ model: this.entity.name,
118
+ rows: opts.rows,
119
+ operation: opts.operation,
120
+ });
121
+ }
122
+ /**
123
+ * Row scope from `@model` settings.access - AND-composed like a default filter, but never
101
124
  * skippable via `shouldSkipDefaultFilter`: that flag serves `restore()`'s deliberate reach past
102
125
  * soft-delete, which must not also reach past tenant/ownership scoping.
103
126
  *
@@ -107,11 +130,11 @@ class RelationalBaseRepository extends ignis_kernel_1.AbstractRepository {
107
130
  * reviewed at the repository - never inferable from a request.
108
131
  */
109
132
  applyScopeFilter(opts) {
110
- const { userFilter, dangerouslySkipScopeFilter } = opts;
133
+ const { userFilter, dangerouslySkipScopeFilter, mutation } = opts;
111
134
  if (dangerouslySkipScopeFilter) {
112
135
  return userFilter ?? {};
113
136
  }
114
- const scopeFilterSettings = this.getScopeFilterSettings();
137
+ const scopeFilterSettings = this.getAccessSettings();
115
138
  if (!scopeFilterSettings) {
116
139
  return userFilter ?? {};
117
140
  }
@@ -123,7 +146,19 @@ class RelationalBaseRepository extends ignis_kernel_1.AbstractRepository {
123
146
  return userFilter ?? {};
124
147
  }
125
148
  if (scopeWhere !== null && scopeWhere !== undefined) {
126
- return this.queryDialect.mergeFilter({ defaultFilter: { where: scopeWhere }, userFilter });
149
+ // A write reaches only the rows it may write: the shared (null) rows a read scope allows need `write.sharedRows`.
150
+ const effectiveWhere = mutation === undefined
151
+ ? scopeWhere
152
+ : scope_write_guard_1.ScopeWriteGuard.mutationWhere({
153
+ settings: scopeFilterSettings,
154
+ model: this.entity.name,
155
+ operation: mutation,
156
+ scopeWhere,
157
+ });
158
+ return this.queryDialect.mergeFilter({
159
+ defaultFilter: { where: effectiveWhere },
160
+ userFilter,
161
+ });
127
162
  }
128
163
  if (scopeFilterSettings.onMissing === ignis_kernel_1.ScopeFilterMissingBehaviors.ALLOW) {
129
164
  return userFilter ?? {};
@@ -137,8 +172,12 @@ class RelationalBaseRepository extends ignis_kernel_1.AbstractRepository {
137
172
  }
138
173
  /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter - the row scope from applyScopeFilter is not. */
139
174
  applyDefaultFilter(opts) {
140
- const { userFilter, shouldSkipDefaultFilter, dangerouslySkipScopeFilter } = opts;
141
- const scopedFilter = this.applyScopeFilter({ userFilter, dangerouslySkipScopeFilter });
175
+ const { userFilter, shouldSkipDefaultFilter, dangerouslySkipScopeFilter, mutation } = opts;
176
+ const scopedFilter = this.applyScopeFilter({
177
+ userFilter,
178
+ dangerouslySkipScopeFilter,
179
+ mutation,
180
+ });
142
181
  if (shouldSkipDefaultFilter) {
143
182
  return scopedFilter;
144
183
  }