@starci/eslint-canon-be 3.18.3 → 3.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/comments.js +1 -1
  3. package/dist/explicit-surface.js +1 -1
  4. package/dist/index.js +1 -1
  5. package/dist/jwt-alg.js +1 -1
  6. package/dist/lib/edition.d.ts +1 -1
  7. package/dist/lib/edition.js +1 -1
  8. package/dist/lib/hfs.d.ts +0 -6
  9. package/dist/lib/hfs.js +7 -5
  10. package/dist/lib/runtime-root.d.ts +6 -1
  11. package/dist/lib/runtime-root.js +8 -2
  12. package/dist/lib/subject-values.js +1 -1
  13. package/dist/module-layering.js +2 -2
  14. package/dist/project-graph.js +1 -1
  15. package/dist/third-party-owner.js +1 -1
  16. package/package.json +3 -1
  17. package/runtime/bundle.json +1 -190
  18. package/runtime/scripts/api/git/recorded-lines.mjs +5 -5
  19. package/runtime/scripts/hfs/project-graph.mjs +6 -6
  20. package/runtime/scripts/hfs/project-rule.mjs +3 -3
  21. package/runtime/config.example.yaml +0 -194
  22. package/runtime/engine/by-code-unit.mjs +0 -12
  23. package/runtime/engine/config.mjs +0 -461
  24. package/runtime/engine/invalid-config.mjs +0 -15
  25. package/runtime/engine/model-config.mjs +0 -112
  26. package/runtime/engine/orca-config.mjs +0 -34
  27. package/runtime/engine/plain-object.mjs +0 -5
  28. package/runtime/engine/release-config.mjs +0 -32
  29. package/runtime/engine/removed-vocabulary.mjs +0 -27
  30. package/runtime/engine/resources-config.mjs +0 -59
  31. package/runtime/engine/runtime-root.mjs +0 -138
  32. package/runtime/engine/secrets.mjs +0 -202
  33. package/runtime/engine/sonar-config.mjs +0 -24
  34. package/runtime/engine/temp-root.mjs +0 -26
  35. package/runtime/engine/yaml.mjs +0 -161
  36. package/runtime/knowledge/grammars/index.yaml +0 -114
  37. package/runtime/knowledge/hfs/canon-pins.yaml +0 -716
  38. package/runtime/knowledge/hfs/fe-stack.yaml +0 -272
  39. package/runtime/knowledge/hfs/rules.yaml +0 -6760
  40. package/runtime/knowledge/hfs/slots.yaml +0 -2783
  41. package/runtime/knowledge/patterns/fe/folder.yaml +0 -425
  42. package/runtime/knowledge/sonar-gate.yaml +0 -151
  43. package/runtime/modules/kernel/removed-vocabulary.yaml +0 -458
  44. package/runtime/modules/models/registry.yaml +0 -221
  45. package/runtime/modules/models/runtimes.yaml +0 -556
  46. package/runtime/modules/models/tiers.yaml +0 -66
  47. package/runtime/scripts/api/git/cat-file.mjs +0 -4
  48. package/runtime/scripts/api/git/config-get.mjs +0 -9
  49. package/runtime/scripts/api/git/diff.mjs +0 -4
  50. package/runtime/scripts/api/git/lib.mjs +0 -80
  51. package/runtime/scripts/api/git/ls-files.mjs +0 -5
  52. package/runtime/scripts/api/git/ls-tree.mjs +0 -4
  53. package/runtime/scripts/api/git/merge-base.mjs +0 -8
  54. package/runtime/scripts/api/git/remote.mjs +0 -4
  55. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -4
  56. package/runtime/scripts/api/git/show.mjs +0 -5
  57. package/runtime/scripts/api/git/tag.mjs +0 -4
  58. package/runtime/scripts/hfs/allows.mjs +0 -77
  59. package/runtime/scripts/hfs/architecture/ast-walks.mjs +0 -250
  60. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +0 -103
  61. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +0 -114
  62. package/runtime/scripts/hfs/architecture/backend.mjs +0 -462
  63. package/runtime/scripts/hfs/architecture/background-unowned.mjs +0 -254
  64. package/runtime/scripts/hfs/architecture/canon-clones.mjs +0 -291
  65. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +0 -224
  66. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +0 -102
  67. package/runtime/scripts/hfs/architecture/clones.mjs +0 -287
  68. package/runtime/scripts/hfs/architecture/component-tiers.mjs +0 -161
  69. package/runtime/scripts/hfs/architecture/config-unread.mjs +0 -16
  70. package/runtime/scripts/hfs/architecture/config.mjs +0 -407
  71. package/runtime/scripts/hfs/architecture/connection-map.mjs +0 -350
  72. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +0 -115
  73. package/runtime/scripts/hfs/architecture/context-coupling.mjs +0 -117
  74. package/runtime/scripts/hfs/architecture/context-map.mjs +0 -355
  75. package/runtime/scripts/hfs/architecture/context-owner.mjs +0 -102
  76. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +0 -65
  77. package/runtime/scripts/hfs/architecture/context-transaction.mjs +0 -75
  78. package/runtime/scripts/hfs/architecture/contract-bounds.mjs +0 -72
  79. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +0 -177
  80. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +0 -360
  81. package/runtime/scripts/hfs/architecture/contracts.mjs +0 -489
  82. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +0 -81
  83. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +0 -173
  84. package/runtime/scripts/hfs/architecture/dead-exports.mjs +0 -420
  85. package/runtime/scripts/hfs/architecture/default-deny.mjs +0 -175
  86. package/runtime/scripts/hfs/architecture/doc-language.mjs +0 -45
  87. package/runtime/scripts/hfs/architecture/entity-registry.mjs +0 -51
  88. package/runtime/scripts/hfs/architecture/entrypoint.mjs +0 -75
  89. package/runtime/scripts/hfs/architecture/error-codes.mjs +0 -54
  90. package/runtime/scripts/hfs/architecture/error-masked.mjs +0 -78
  91. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +0 -44
  92. package/runtime/scripts/hfs/architecture/feature-shape.mjs +0 -60
  93. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +0 -41
  94. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +0 -112
  95. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +0 -193
  96. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +0 -198
  97. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +0 -368
  98. package/runtime/scripts/hfs/architecture/frontend-world.mjs +0 -374
  99. package/runtime/scripts/hfs/architecture/frontend.mjs +0 -248
  100. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +0 -185
  101. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +0 -77
  102. package/runtime/scripts/hfs/architecture/hfs.mjs +0 -394
  103. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +0 -118
  104. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +0 -213
  105. package/runtime/scripts/hfs/architecture/identity.mjs +0 -121
  106. package/runtime/scripts/hfs/architecture/index.mjs +0 -402
  107. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +0 -69
  108. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +0 -231
  109. package/runtime/scripts/hfs/architecture/machine-ast.mjs +0 -232
  110. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +0 -32
  111. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +0 -237
  112. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +0 -126
  113. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +0 -192
  114. package/runtime/scripts/hfs/architecture/next-data-key.mjs +0 -374
  115. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +0 -26
  116. package/runtime/scripts/hfs/architecture/next-data.mjs +0 -425
  117. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +0 -55
  118. package/runtime/scripts/hfs/architecture/owners.mjs +0 -142
  119. package/runtime/scripts/hfs/architecture/package-shape.mjs +0 -92
  120. package/runtime/scripts/hfs/architecture/presentation.mjs +0 -173
  121. package/runtime/scripts/hfs/architecture/reachability.mjs +0 -330
  122. package/runtime/scripts/hfs/architecture/register-once.mjs +0 -212
  123. package/runtime/scripts/hfs/architecture/registration.mjs +0 -372
  124. package/runtime/scripts/hfs/architecture/render-graph.mjs +0 -449
  125. package/runtime/scripts/hfs/architecture/render-prop-across-server.mjs +0 -58
  126. package/runtime/scripts/hfs/architecture/required-files.mjs +0 -237
  127. package/runtime/scripts/hfs/architecture/root-packages.mjs +0 -78
  128. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +0 -133
  129. package/runtime/scripts/hfs/architecture/schema-owner.mjs +0 -288
  130. package/runtime/scripts/hfs/architecture/server-action.mjs +0 -78
  131. package/runtime/scripts/hfs/architecture/side-boundary.mjs +0 -13
  132. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +0 -320
  133. package/runtime/scripts/hfs/architecture/source-names.mjs +0 -393
  134. package/runtime/scripts/hfs/architecture/sql-keys.mjs +0 -344
  135. package/runtime/scripts/hfs/architecture/sql-owner.mjs +0 -291
  136. package/runtime/scripts/hfs/architecture/sql-returning.mjs +0 -76
  137. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +0 -117
  138. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +0 -587
  139. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +0 -42
  140. package/runtime/scripts/hfs/architecture/surface-nesting.mjs +0 -127
  141. package/runtime/scripts/hfs/architecture/surface.mjs +0 -88
  142. package/runtime/scripts/hfs/architecture/symbols.mjs +0 -273
  143. package/runtime/scripts/hfs/architecture/test-world-files.mjs +0 -263
  144. package/runtime/scripts/hfs/architecture/tiers.mjs +0 -256
  145. package/runtime/scripts/hfs/architecture/transport-owner.mjs +0 -248
  146. package/runtime/scripts/hfs/architecture/type-context.mjs +0 -335
  147. package/runtime/scripts/hfs/architecture/typescript.mjs +0 -477
  148. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +0 -165
  149. package/runtime/scripts/hfs/declaration-shape.mjs +0 -196
  150. package/runtime/scripts/hfs/declaration-slots.mjs +0 -89
  151. package/runtime/scripts/hfs/edition-slots.mjs +0 -80
  152. package/runtime/scripts/hfs/explicit-surface-rule.mjs +0 -59
  153. package/runtime/scripts/hfs/linear-text.mjs +0 -30
  154. package/runtime/scripts/hfs/manifest-shape.mjs +0 -474
  155. package/runtime/scripts/hfs/param-names.mjs +0 -13
  156. package/runtime/scripts/hfs/path-findings.mjs +0 -167
  157. package/runtime/scripts/hfs/repo-identity.mjs +0 -89
  158. package/runtime/scripts/hfs/rule-catalog.mjs +0 -458
  159. package/runtime/scripts/hfs/rule-params-shape.mjs +0 -103
  160. package/runtime/scripts/hfs/rules/database-constants.mjs +0 -25
  161. package/runtime/scripts/hfs/rules/database-migrations.mjs +0 -684
  162. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +0 -68
  163. package/runtime/scripts/hfs/rules/read.mjs +0 -45
  164. package/runtime/scripts/hfs/rules/secrets.mjs +0 -79
  165. package/runtime/scripts/hfs/rules/spec-placement.mjs +0 -28
  166. package/runtime/scripts/hfs/slot-app-view.mjs +0 -97
  167. package/runtime/scripts/hfs/slot-classify.mjs +0 -69
  168. package/runtime/scripts/hfs/slot-errors.mjs +0 -12
  169. package/runtime/scripts/hfs/slot-imports.mjs +0 -98
  170. package/runtime/scripts/hfs/slot-manifest-shape.mjs +0 -111
  171. package/runtime/scripts/hfs/slot-match.mjs +0 -164
  172. package/runtime/scripts/hfs/slot-path.mjs +0 -6
  173. package/runtime/scripts/hfs/slot-required.mjs +0 -95
  174. package/runtime/scripts/hfs/slot-semantic-problems.mjs +0 -175
  175. package/runtime/scripts/hfs/slot-side-problems.mjs +0 -32
  176. package/runtime/scripts/hfs/slots.mjs +0 -306
  177. package/runtime/scripts/hfs/test-world-slot.mjs +0 -5
  178. package/runtime/scripts/hfs/trailing-slashes.mjs +0 -8
  179. package/runtime/scripts/hfs/typescript-programs.mjs +0 -95
  180. package/runtime/scripts/hfs/view.mjs +0 -180
  181. package/runtime/scripts/lib/declaration-surface.mjs +0 -166
  182. package/runtime/scripts/lib/dockerfile.mjs +0 -164
  183. package/runtime/scripts/lib/env.mjs +0 -18
  184. package/runtime/scripts/lib/event-contract.mjs +0 -102
  185. package/runtime/scripts/lib/git-hooks-dir.mjs +0 -30
  186. package/runtime/scripts/lib/git.mjs +0 -35
  187. package/runtime/scripts/lib/glob.mjs +0 -32
  188. package/runtime/scripts/lib/grammar-lint.mjs +0 -57
  189. package/runtime/scripts/lib/i18n.mjs +0 -82
  190. package/runtime/scripts/lib/in-order.mjs +0 -90
  191. package/runtime/scripts/lib/json-clone.mjs +0 -70
  192. package/runtime/scripts/lib/json.mjs +0 -44
  193. package/runtime/scripts/lib/language.mjs +0 -233
  194. package/runtime/scripts/lib/list.mjs +0 -26
  195. package/runtime/scripts/lib/mutation-fence.mjs +0 -20
  196. package/runtime/scripts/lib/package-at.mjs +0 -62
  197. package/runtime/scripts/lib/path-key.mjs +0 -124
  198. package/runtime/scripts/lib/read-text.mjs +0 -47
  199. package/runtime/scripts/lib/regex.mjs +0 -3
  200. package/runtime/scripts/lib/rule-packs.mjs +0 -243
  201. package/runtime/scripts/lib/same-text.mjs +0 -4
  202. package/runtime/scripts/lib/secret-patterns.mjs +0 -230
  203. package/runtime/scripts/lib/sops-envelope.mjs +0 -212
  204. package/runtime/scripts/lib/stack-services.mjs +0 -191
  205. package/runtime/scripts/lib/ts-analysis.mjs +0 -39
  206. package/runtime/scripts/lib/ts-ast.mjs +0 -63
  207. package/runtime/scripts/lib/walk.mjs +0 -45
  208. package/runtime/scripts/lib/yaml-cached.mjs +0 -14
@@ -1,587 +0,0 @@
1
- /**
2
- * A small PostgreSQL text reader for the R86 machine check (sql-owner). No SQL parser is a dependency of the runtime, so
3
- * this is a tokenizer plus a clause scanner, written for exactly what the check needs: which tables a statement
4
- * writes, which it reads, and whether a SELECT is bounded. Comments and string literals never reach the scanner.
5
- * A substitution of the `sql` tag (a `${...}` hole, the SqlIdent form) is an opaque token: a table position that holds
6
- * one is counted as dynamic and judged by nobody.
7
- */
8
- import { depths, equalityColumns, isName, isWord, matching, nameOf, scalarCastAt } from './sql-token-forms.mjs';
9
- export const HOLE = '';
10
- const tokenAt = (tokens, index) => tokens[index];
11
- /** The upper-cased spelling of a word token ('' for a token that has none). */
12
- const upOf = (token) => token?.up ?? '';
13
- const isSpace = (char) => /\s/u.test(char);
14
- const isWordStart = (char) => /[\p{L}_]/u.test(char);
15
- const isWordPart = (char) => /[\p{L}\p{N}_$]/u.test(char);
16
- const commentEnd = (text, index) => {
17
- if (text[index] === '-' && text[index + 1] === '-') {
18
- while (index < text.length && text[index] !== '\n')
19
- index += 1;
20
- return index;
21
- }
22
- if (text[index] !== '/' || text[index + 1] !== '*')
23
- return null;
24
- const end = text.indexOf('*/', index + 2);
25
- return end === -1 ? text.length : end + 2;
26
- };
27
- const singleQuotedEnd = (text, index, push) => {
28
- if (text[index] !== "'")
29
- return null;
30
- index += 1;
31
- while (index < text.length) {
32
- if (text[index] === "'" && text[index + 1] === "'") {
33
- index += 2;
34
- continue;
35
- }
36
- if (text[index] === "'")
37
- break;
38
- index += 1;
39
- }
40
- push('string', '');
41
- return index + 1;
42
- };
43
- const quotedIdentifierEnd = (text, index, push) => {
44
- if (text[index] !== '"')
45
- return null;
46
- let value = '';
47
- index += 1;
48
- while (index < text.length) {
49
- if (text[index] === '"' && text[index + 1] === '"') {
50
- value += '"';
51
- index += 2;
52
- continue;
53
- }
54
- if (text[index] === '"')
55
- break;
56
- value += text[index];
57
- index += 1;
58
- }
59
- push('ident', value);
60
- return index + 1;
61
- };
62
- const dollarTokenEnd = (text, index, push) => {
63
- if (text[index] !== '$')
64
- return null;
65
- const param = /^\$(\d+)/u.exec(text.slice(index, index + 12));
66
- if (param) {
67
- push('param', param[0]);
68
- return index + param[0].length;
69
- }
70
- const tag = /^\$([\p{L}_][\p{L}\p{N}_]*)?\$/u.exec(text.slice(index));
71
- if (!tag)
72
- return null;
73
- const end = text.indexOf(tag[0], index + tag[0].length);
74
- push('string', '');
75
- return end === -1 ? text.length : end + tag[0].length;
76
- };
77
- const numberEnd = (text, index, push) => {
78
- if (!/\d/u.test(text[index]))
79
- return null;
80
- let end = index;
81
- while (end < text.length && /[\d.]/u.test(text[end]))
82
- end += 1;
83
- push('number', text.slice(index, end));
84
- return end;
85
- };
86
- const wordEnd = (text, index, push) => {
87
- if (!isWordStart(text[index]))
88
- return null;
89
- let end = index;
90
- while (end < text.length && isWordPart(text[end]))
91
- end += 1;
92
- const word = text.slice(index, end);
93
- if (text[end] !== "'" || !/^[EeBbXxNn]$/u.test(word)) {
94
- push('word', word);
95
- return end;
96
- }
97
- const escaped = /^[Ee]$/u.test(word);
98
- end += 1;
99
- while (end < text.length) {
100
- if (escaped && text[end] === '\\') {
101
- end += 2;
102
- continue;
103
- }
104
- if (text[end] === "'" && text[end + 1] === "'") {
105
- end += 2;
106
- continue;
107
- }
108
- if (text[end] === "'")
109
- break;
110
- end += 1;
111
- }
112
- push('string', '');
113
- return end + 1;
114
- };
115
- const punctuationEnd = (text, index, push) => {
116
- const two = text.slice(index, index + 2);
117
- if (['::', '<=', '>=', '<>', '!=', '||', '->'].includes(two)) {
118
- push('punct', two);
119
- return index + 2;
120
- }
121
- push('punct', text[index]);
122
- return index + 1;
123
- };
124
- function consumeToken(text, index, push) {
125
- const comment = commentEnd(text, index);
126
- if (comment !== null)
127
- return comment;
128
- if (text[index] === HOLE) {
129
- push('hole', HOLE);
130
- return index + 1;
131
- }
132
- const singleQuoted = singleQuotedEnd(text, index, push);
133
- if (singleQuoted !== null)
134
- return singleQuoted;
135
- const identifier = quotedIdentifierEnd(text, index, push);
136
- if (identifier !== null)
137
- return identifier;
138
- const dollarToken = dollarTokenEnd(text, index, push);
139
- if (dollarToken !== null)
140
- return dollarToken;
141
- const number = numberEnd(text, index, push);
142
- if (number !== null)
143
- return number;
144
- const word = wordEnd(text, index, push);
145
- return word ?? punctuationEnd(text, index, push);
146
- }
147
- /** Tokens: {t: 'word'|'ident'|'string'|'number'|'param'|'hole'|'punct', v, up?} (`up` is the uppercase word). */
148
- export function tokenizeSql(text) {
149
- const tokens = [];
150
- let i = 0;
151
- const push = (t, v) => tokens.push(t === 'word' ? { t, v, up: v.toUpperCase() } : { t, v });
152
- while (i < text.length) {
153
- const char = text[i];
154
- if (isSpace(char)) {
155
- i += 1;
156
- continue;
157
- }
158
- i = consumeToken(text, i, push);
159
- }
160
- return tokens;
161
- }
162
- const CLAUSE_WORDS = new Set(['WHERE', 'JOIN', 'INNER', 'LEFT', 'RIGHT', 'FULL', 'CROSS', 'NATURAL', 'ON', 'USING', 'GROUP', 'ORDER', 'LIMIT', 'OFFSET',
163
- 'HAVING', 'UNION', 'INTERSECT', 'EXCEPT', 'WINDOW', 'FOR', 'RETURNING', 'SET', 'VALUES', 'SELECT', 'FETCH', 'OUTER', 'TABLESAMPLE', 'WITH', 'AS']);
164
- // PostgreSQL aggregate function names, kept as one string so they read as words, not as failure codes.
165
- const AGGREGATES = new Set('COUNT SUM AVG MIN MAX BOOL_AND BOOL_OR EVERY ARRAY_AGG STRING_AGG JSON_AGG JSONB_AGG JSON_OBJECT_AGG JSONB_OBJECT_AGG BIT_AND BIT_OR STDDEV VARIANCE'.split(' '));
166
- const FROM_INSIDE = new Set(['EXTRACT', 'SUBSTRING', 'TRIM', 'OVERLAY', 'POSITION']);
167
- const NOT_A_WRITE_BEFORE_UPDATE = new Set(['FOR', 'DO', 'ON', 'KEY', 'SHARE', 'OF']);
168
- const WHERE_END = new Set(['GROUP', 'ORDER', 'HAVING', 'LIMIT', 'OFFSET', 'UNION', 'INTERSECT', 'EXCEPT', 'FOR', 'WINDOW', 'RETURNING', 'FETCH']);
169
- const SYSTEM_SCHEMAS = new Set(['pg_catalog', 'information_schema']);
170
- /**
171
- * The table reference at `start`: {parts, table, alias, next}, {dynamic: true}, or null (a subquery, a function, nothing).
172
- * `next` is the index after the reference and its alias.
173
- */
174
- function tableNameAt(tokens, start) {
175
- let i = start;
176
- while (isWord(tokens[i], 'ONLY') || isWord(tokens[i], 'LATERAL'))
177
- i += 1;
178
- const first = tokens[i];
179
- if (first?.t === 'hole')
180
- return { dynamic: true, next: i + 1 };
181
- if (!isName(first) || (first.t === 'word' && CLAUSE_WORDS.has(upOf(first)) && first.up !== 'AS'))
182
- return null;
183
- const parts = [nameOf(first)];
184
- i += 1;
185
- for (;;) {
186
- const part = tokens[i + 1];
187
- if (!(tokens[i]?.v === '.' && isName(part)))
188
- break;
189
- parts.push(nameOf(part));
190
- i += 2;
191
- }
192
- return { parts, next: i };
193
- }
194
- function tableAliasAt(tokens, index) {
195
- const current = tokens[index];
196
- const after = tokens[index + 1];
197
- if (isWord(current, 'AS') && isName(after))
198
- return { alias: nameOf(after), next: index + 2 };
199
- if (isName(current) && !(current.t === 'word' && CLAUSE_WORDS.has(upOf(current))))
200
- return { alias: nameOf(current), next: index + 1 };
201
- return { alias: null, next: index };
202
- }
203
- function columnListEnd(tokens, start) {
204
- let i = start;
205
- let depth = 0;
206
- do {
207
- if (tokenAt(tokens, i).v === '(')
208
- depth += 1;
209
- else if (tokenAt(tokens, i).v === ')')
210
- depth -= 1;
211
- i += 1;
212
- } while (i < tokens.length && depth > 0);
213
- return i;
214
- }
215
- function tableRef(tokens, start, { columns = false } = {}) {
216
- const reference = tableNameAt(tokens, start);
217
- if (!reference)
218
- return null;
219
- if (reference.dynamic)
220
- return reference;
221
- const { parts } = reference;
222
- let i = reference.next;
223
- if (tokens[i]?.v === '(' && !columns)
224
- return null;
225
- const { alias, next } = tableAliasAt(tokens, i);
226
- i = next;
227
- if (alias && tokens[i]?.v === '(')
228
- i = columnListEnd(tokens, i);
229
- return { parts, table: parts.at(-1), schema: parts.length > 1 ? parts.at(-2) : null, alias, next: i };
230
- }
231
- function statementsOf(tokens) {
232
- const statements = [];
233
- let current = [];
234
- let depth = 0;
235
- for (const token of tokens) {
236
- if (token.t === 'punct' && token.v === '(')
237
- depth += 1;
238
- if (token.t === 'punct' && token.v === ')')
239
- depth -= 1;
240
- if (token.t === 'punct' && token.v === ';' && depth <= 0) {
241
- if (current.length) {
242
- statements.push(current);
243
- }
244
- current = [];
245
- continue;
246
- }
247
- current.push(token);
248
- }
249
- if (current.length)
250
- statements.push(current);
251
- return statements;
252
- }
253
- function cteNameBefore(tokens, index) {
254
- let afterAs = index + 1;
255
- if (isWord(tokens[afterAs], 'NOT'))
256
- afterAs += 1;
257
- if (isWord(tokens[afterAs], 'MATERIALIZED'))
258
- afterAs += 1;
259
- if (tokens[afterAs]?.v !== '(')
260
- return null;
261
- let nameIndex = index - 1;
262
- if (tokens[nameIndex]?.v === ')') {
263
- let depth = 0;
264
- do {
265
- if (tokenAt(tokens, nameIndex).v === ')')
266
- depth += 1;
267
- else if (tokenAt(tokens, nameIndex).v === '(')
268
- depth -= 1;
269
- nameIndex -= 1;
270
- } while (nameIndex >= 0 && depth > 0);
271
- }
272
- const before = tokens[nameIndex - 1];
273
- const named = tokens[nameIndex];
274
- if (isName(named) && (isWord(before, 'WITH') || isWord(before, 'RECURSIVE') || before?.v === ','))
275
- return nameOf(named);
276
- return null;
277
- }
278
- /** The CTE names a statement declares: `name [(cols)] AS [NOT] [MATERIALIZED] (`. */
279
- function cteNames(tokens) {
280
- const names = new Set();
281
- for (let i = 1; i < tokens.length; i += 1) {
282
- if (!isWord(tokens[i], 'AS'))
283
- continue;
284
- const name = cteNameBefore(tokens, i);
285
- if (name !== null)
286
- names.add(name);
287
- }
288
- return names;
289
- }
290
- function isAggregateItem(item) {
291
- for (let i = 0; i < item.length; i += 1) {
292
- const token = tokenAt(item, i);
293
- if (token.t === 'word' && AGGREGATES.has(upOf(token)) && item[i + 1]?.v === '(') {
294
- const close = matching(item, i + 1);
295
- if (!isWord(item[close + 1], 'OVER'))
296
- return true;
297
- }
298
- }
299
- return false;
300
- }
301
- /** The unique-key columns `columns` (lowercase Set of `=`-constrained column names) satisfy for one of `uniqueSets`. */
302
- const covers = (uniqueSets, columns) => uniqueSets.some(set => set.length > 0 && set.every(column => columns.has(column)));
303
- /**
304
- * Judge one statement that reads rows (no INSERT/UPDATE/DELETE/MERGE at its own depth): `{bounded, basis}`. Bounded is
305
- * a LIMIT/FETCH at the statement depth, no FROM at all (one row), only aggregates without GROUP BY, or an equality on
306
- * every column of the primary key or of one unique key of a single FROM relation. Unknown projection calls can
307
- * multiply rows even when that relation contributes at most one, so they need an explicit statement bound.
308
- */
309
- function aggregateSelectItems(tokens, level, select, from) {
310
- const items = [];
311
- let item = [];
312
- for (let i = select + 1; i < from; i += 1) {
313
- const token = tokenAt(tokens, i);
314
- if (level[i] === 0 && token.v === ',' && token.t === 'punct') {
315
- items.push(item);
316
- item = [];
317
- continue;
318
- }
319
- if (!(items.length === 0 && item.length === 0 && (isWord(token, 'DISTINCT') || isWord(token, 'ALL'))))
320
- item.push(token);
321
- }
322
- items.push(item);
323
- return items;
324
- }
325
- function whereRegion(tokens, level, where) {
326
- const region = [];
327
- for (let i = where + 1; i < tokens.length; i += 1) {
328
- const token = tokenAt(tokens, i);
329
- if (level[i] === 0 && token.t === 'word' && WHERE_END.has(upOf(token)))
330
- break;
331
- region.push({ token, level: level[i] });
332
- }
333
- return region;
334
- }
335
- /** The tokens of a WHERE region split at its top-level AND; the AND of a BETWEEN stays inside its conjunct. */
336
- function splitConjuncts(region) {
337
- const conjuncts = [[]];
338
- let between = false;
339
- for (const entry of region) {
340
- const top = entry.level === 0;
341
- if (top && isWord(entry.token, 'BETWEEN'))
342
- between = true;
343
- const isAnd = top && isWord(entry.token, 'AND');
344
- if (isAnd && !between) {
345
- conjuncts.push([]);
346
- continue;
347
- }
348
- if (isAnd)
349
- between = false;
350
- conjuncts.at(-1).push(entry.token);
351
- }
352
- return conjuncts;
353
- }
354
- function uniqueWhereColumns(region, primary) {
355
- if (region.some(entry => entry.level === 0 && isWord(entry.token, 'OR')))
356
- return null;
357
- const conjuncts = splitConjuncts(region);
358
- const qualifiers = new Set([primary.table, primary.alias].filter((name) => Boolean(name)));
359
- const columns = new Set();
360
- for (const conjunct of conjuncts)
361
- for (const column of equalityColumns(conjunct, qualifiers))
362
- columns.add(column);
363
- return columns;
364
- }
365
- function findTopWord(tokens, level, up, from = 0) {
366
- for (let i = from; i < tokens.length; i += 1) {
367
- if (level[i] === 0 && isWord(tokens[i], up))
368
- return i;
369
- }
370
- return -1;
371
- }
372
- const hasTopGroupBy = (tokens, level) => tokens.some((token, i) => level[i] === 0 && isWord(token, 'GROUP') && isWord(tokens[i + 1], 'BY'));
373
- function isUniqueBounded(tokens, level, from, primary, uniqueSets) {
374
- const where = findTopWord(tokens, level, 'WHERE', from);
375
- if (!uniqueSets?.length || where < 0)
376
- return false;
377
- const columns = uniqueWhereColumns(whereRegion(tokens, level, where), primary);
378
- return columns !== null && covers(uniqueSets, columns);
379
- }
380
- function singleFromRelation(tokens, level, from) {
381
- for (let index = from + 1; index < tokens.length; index += 1) {
382
- if (level[index] !== 0)
383
- continue;
384
- const token = tokenAt(tokens, index);
385
- if (isWord(token, 'WHERE') || (token.t === 'word' && WHERE_END.has(upOf(token))))
386
- break;
387
- if (isWord(token, 'JOIN') || (token.t === 'punct' && token.v === ','))
388
- return false;
389
- }
390
- return true;
391
- }
392
- // Functions that return a set of rows when they stand in a select list. A select list holding one multiplies the rows.
393
- const SET_RETURNING = new Set(`GENERATE_SERIES GENERATE_SUBSCRIPTS UNNEST REGEXP_MATCHES REGEXP_SPLIT_TO_TABLE STRING_TO_TABLE
394
- JSON_EACH JSONB_EACH JSON_EACH_TEXT JSONB_EACH_TEXT JSON_ARRAY_ELEMENTS JSONB_ARRAY_ELEMENTS JSON_ARRAY_ELEMENTS_TEXT JSONB_ARRAY_ELEMENTS_TEXT
395
- JSON_OBJECT_KEYS JSONB_OBJECT_KEYS JSON_TO_RECORDSET JSONB_TO_RECORDSET JSON_POPULATE_RECORDSET JSONB_POPULATE_RECORDSET
396
- JSONB_PATH_QUERY JSONB_PATH_QUERY_TZ JSON_TABLE PG_LS_DIR PG_LS_WALDIR PG_LS_LOGDIR PG_LISTENING_CHANNELS PG_SHOW_ALL_SETTINGS PG_GET_KEYWORDS ACLEXPLODE TS_STAT TS_DEBUG`.split(/\s+/u));
397
- // Scalar builtins and operator-like words that are no row-multiplying call; the aggregate-only shape accepts these around its aggregates.
398
- const SCALAR_CALLS = new Set(`COALESCE NULLIF GREATEST LEAST ROUND CEIL CEILING FLOOR ABS TRUNC EXTRACT DATE_PART DATE_TRUNC TO_CHAR LOWER UPPER LENGTH CONCAT
399
- JSONB_BUILD_OBJECT JSONB_BUILD_ARRAY JSON_BUILD_OBJECT JSON_BUILD_ARRAY TO_JSONB TO_JSON`.split(/\s+/u));
400
- const NOT_A_CALL = new Set(['IN', 'ANY', 'ALL', 'SOME', 'AND', 'OR', 'NOT', 'FILTER', 'EXISTS', 'CASE', 'WHEN', 'THEN', 'ELSE', 'AS', 'ON', 'DISTINCT', 'BETWEEN', 'LIKE', 'ILIKE', 'IS', 'WITHIN', 'FROM']);
401
- const callAt = (tokens, index) => {
402
- const token = tokens[index];
403
- return isName(token) && tokens[index + 1]?.v === '(' && !(token.t === 'word' && (NOT_A_CALL.has(upOf(token)) || CLAUSE_WORDS.has(upOf(token))));
404
- };
405
- /** A call to a set-returning function anywhere in the statement (conservative: nested positions count). */
406
- const hasSetReturningCall = (tokens) => tokens.some((token, index) => callAt(tokens, index) && token.t === 'word' && SET_RETURNING.has(upOf(token)));
407
- const hasWindow = (tokens) => tokens.some(token => isWord(token, 'OVER'));
408
- /** Plain known aggregate calls and known scalar builtins are scalar; other calls, including wrappers around aggregates, may return sets. */
409
- function unprovenProjectionCall(tokens, level, select, from) {
410
- const end = from < 0 ? tokens.length : from;
411
- for (let index = select + 1; index < end; index += 1) {
412
- const token = tokenAt(tokens, index);
413
- if (level[index] === 0 && (isWord(token, 'WHERE') || (token.t === 'word' && WHERE_END.has(upOf(token)))))
414
- break;
415
- if (!callAt(tokens, index))
416
- continue;
417
- if (scalarCastAt(tokens, index))
418
- continue;
419
- const known = token.t === 'word' && tokens[index - 1]?.v !== '.' && (AGGREGATES.has(upOf(token)) || SCALAR_CALLS.has(upOf(token)));
420
- if (!known)
421
- return true;
422
- }
423
- return false;
424
- }
425
- /**
426
- * A SELECT that returns at most one row by construction: it has no FROM (one row, unless a set-returning function multiplies it),
427
- * or it selects only aggregates (plain or inside known scalar calls and casts) with no GROUP BY, window or set-returning function.
428
- */
429
- function singleRowBound(tokens, level, select, from, grouped) {
430
- if (hasSetReturningCall(tokens) || hasWindow(tokens))
431
- return null;
432
- if (from < 0)
433
- return grouped ? null : { bounded: true, basis: 'no from' };
434
- if (!grouped && !unprovenProjectionCall(tokens, level, select, from) && aggregateSelectItems(tokens, level, select, from).every(isAggregateItem))
435
- return { bounded: true, basis: 'aggregate' };
436
- return null;
437
- }
438
- function selectBound(tokens, level, uniqueSetsOf, cte) {
439
- if (findTopWord(tokens, level, 'LIMIT') >= 0 || findTopWord(tokens, level, 'FETCH') >= 0)
440
- return { bounded: true, basis: 'limit' };
441
- const select = findTopWord(tokens, level, 'SELECT');
442
- const from = findTopWord(tokens, level, 'FROM', select);
443
- const primary = from < 0 ? null : tableRef(tokens, from + 1);
444
- const unbounded = { bounded: false, basis: 'unbounded', table: primary && !primary.dynamic ? primary.table : null };
445
- const grouped = hasTopGroupBy(tokens, level);
446
- if (tokens.some((token, index) => level[index] === 0 && (isWord(token, 'UNION') || isWord(token, 'INTERSECT') || isWord(token, 'EXCEPT'))))
447
- return unbounded;
448
- const single = singleRowBound(tokens, level, select, from, grouped);
449
- if (single)
450
- return single;
451
- if (unprovenProjectionCall(tokens, level, select, from) || hasSetReturningCall(tokens))
452
- return unbounded;
453
- if (grouped || from < 0 || !primary || primary.dynamic || cte.has(primary.table) || !singleFromRelation(tokens, level, from))
454
- return unbounded;
455
- if (isUniqueBounded(tokens, level, from, primary, uniqueSetsOf(primary.table, primary.schema)))
456
- return { bounded: true, basis: 'unique' };
457
- return unbounded;
458
- }
459
- function recordSqlReference(list, ref, reads, cte, state) {
460
- if (!ref)
461
- return;
462
- if (ref.dynamic) {
463
- state.dynamic += 1;
464
- return;
465
- }
466
- if (ref.schema && SYSTEM_SCHEMAS.has(ref.schema))
467
- return;
468
- if (ref.table.startsWith('pg_'))
469
- return;
470
- if (list === reads && !ref.schema && cte.has(ref.table))
471
- return;
472
- list.push({ table: ref.table, schema: ref.schema });
473
- }
474
- function recordTableList(tokens, start, list, record, commaIsPunctuation) {
475
- let i = start;
476
- for (;;) {
477
- const ref = tableRef(tokens, i);
478
- record(list, ref);
479
- if (ref && tokens[ref.next]?.v === ',' && (!commaIsPunctuation || tokenAt(tokens, ref.next).t === 'punct')) {
480
- i = ref.next + 1;
481
- continue;
482
- }
483
- break;
484
- }
485
- }
486
- // Where the table reference of a write verb starts (an offset from the verb) and whether it may carry a column list; null for any other token.
487
- function writeTarget(token, next, previous) {
488
- if (token.up === 'INSERT' && isWord(next, 'INTO'))
489
- return { offset: 2, columns: true };
490
- if (token.up === 'UPDATE' && !(previous?.t === 'word' && NOT_A_WRITE_BEFORE_UPDATE.has(upOf(previous))))
491
- return { offset: 1, columns: false };
492
- if ((token.up === 'DELETE' && isWord(next, 'FROM')) || (token.up === 'MERGE' && isWord(next, 'INTO')))
493
- return { offset: 2, columns: false };
494
- return null;
495
- }
496
- function processWriteToken(tokens, level, index, token, record, state) {
497
- const target = writeTarget(token, tokens[index + 1], state.previous);
498
- if (target) {
499
- if (level[index] === 0)
500
- state.hasWriteVerb = true;
501
- record(state.writes, tableRef(tokens, index + target.offset, { columns: target.columns }));
502
- return true;
503
- }
504
- if (token.up !== 'TRUNCATE')
505
- return false;
506
- let start = index + 1;
507
- if (isWord(tokens[start], 'TABLE'))
508
- start += 1;
509
- recordTableList(tokens, start, state.writes, record, false);
510
- return true;
511
- }
512
- function processReadToken(tokens, index, token, record, state, mergeOrDelete) {
513
- if (token.up === 'FROM' && !isWord(state.previous, 'DISTINCT') && !isWord(state.previous, 'DELETE') && state.parens.at(-1) !== true) {
514
- recordTableList(tokens, index + 1, state.reads, record, true);
515
- return;
516
- }
517
- if (token.up === 'JOIN') {
518
- record(state.reads, tableRef(tokens, index + 1));
519
- return;
520
- }
521
- if (token.up === 'USING' && mergeOrDelete && tokens[index + 1]?.v !== '(')
522
- record(state.reads, tableRef(tokens, index + 1));
523
- }
524
- function trackParenthesis(tokens, index, state) {
525
- const token = tokenAt(tokens, index);
526
- if (token.t !== 'punct')
527
- return false;
528
- if (token.v === '(') {
529
- const before = tokens[index - 1];
530
- state.parens.push(index > 0 && before !== undefined && before.t === 'word' && FROM_INSIDE.has(upOf(before)));
531
- return true;
532
- }
533
- if (token.v !== ')')
534
- return false;
535
- state.parens.pop();
536
- return true;
537
- }
538
- function statementReferences(tokens, level, cte) {
539
- const state = { writes: [], reads: [], parens: [], dynamic: 0, hasWriteVerb: false };
540
- const record = (list, ref) => recordSqlReference(list, ref, state.reads, cte, state);
541
- const mergeOrDelete = tokens.some(token => isWord(token, 'MERGE')) || tokens.some(token => isWord(token, 'DELETE'));
542
- for (let i = 0; i < tokens.length; i += 1) {
543
- const token = tokenAt(tokens, i);
544
- if (trackParenthesis(tokens, i, state) || token.t !== 'word')
545
- continue;
546
- state.previous = tokens[i - 1];
547
- if (processWriteToken(tokens, level, i, token, record, state)) {
548
- if (token.up === 'DELETE')
549
- i += 1;
550
- continue;
551
- }
552
- processReadToken(tokens, i, token, record, state, mergeOrDelete);
553
- }
554
- return state;
555
- }
556
- function statementAnalysis(tokens, uniqueSetsOf) {
557
- const cte = cteNames(tokens);
558
- const level = depths(tokens);
559
- const references = statementReferences(tokens, level, cte);
560
- const selects = [];
561
- const hasSelect = tokens.some((candidate, i) => level[i] === 0 && isWord(candidate, 'SELECT'));
562
- if (hasSelect && !references.hasWriteVerb)
563
- selects.push(selectBound(tokens, level, uniqueSetsOf, cte));
564
- return { ...references, selects };
565
- }
566
- /**
567
- * Read one SQL text. `uniqueSetsOf(table, schema)` returns the unique-key column sets (each a lowercase column list)
568
- * proven for that relation by its declared schema authority, or null when no key is known.
569
- * Returns {writes: [{table, schema}], reads: [{table, schema}], selects: [{bounded, basis, table}], dynamic}.
570
- */
571
- export function analyzeSql(text, { uniqueSetsOf = () => null } = {}) {
572
- const writes = [];
573
- const reads = [];
574
- const selects = [];
575
- let dynamic = 0;
576
- for (const tokens of statementsOf(tokenizeSql(text))) {
577
- const statement = statementAnalysis(tokens, uniqueSetsOf);
578
- for (const write of statement.writes)
579
- writes.push(write);
580
- for (const read of statement.reads)
581
- reads.push(read);
582
- for (const select of statement.selects)
583
- selects.push(select);
584
- dynamic += statement.dynamic;
585
- }
586
- return { writes, reads, selects, dynamic };
587
- }
@@ -1,42 +0,0 @@
1
- import { catFile } from '../../api/git/cat-file.mjs';
2
- import { diff } from '../../api/git/diff.mjs';
3
- import { gitOutputOf } from '../../lib/git.mjs';
4
- /** Eligible additions, copies, edits and rename destinations in the index, read in one blob batch. */
5
- export function stagedConsumerSources(root, accept) {
6
- try {
7
- const options = { cwd: root, maxBuffer: 256 * 1024 * 1024 };
8
- const files = gitOutputOf(diff(['--cached', '--relative', '--name-only', '--diff-filter=ACMR', '-z', '--', '.'], options))
9
- .split('\0').filter((file) => file && accept(file));
10
- if (!files.length)
11
- return [];
12
- // :./ keeps paths relative to this side's root even when git's top level is the parent app folder.
13
- // -z terminates requests with NUL; output headers and blob trailers still use LF.
14
- const bytes = gitOutputOf(catFile(['--batch', '-z'], {
15
- ...options, encoding: null, input: files.map((file) => `:./${file}\0`).join(''),
16
- }));
17
- if (!Buffer.isBuffer(bytes))
18
- return [];
19
- const sources = [];
20
- let cursor = 0;
21
- for (const file of files) {
22
- const end = bytes.indexOf(10, cursor);
23
- if (end < 0)
24
- return [];
25
- const header = /^[0-9a-f]+ blob (\d+)$/u.exec(bytes.subarray(cursor, end).toString('utf8'));
26
- if (!header)
27
- return []; // An index changed during the read: discard this supplement, keep disk consumers.
28
- const size = Number(header[1]);
29
- const start = end + 1;
30
- const next = start + size;
31
- if (!Number.isSafeInteger(size) || next >= bytes.length || bytes[next] !== 10)
32
- return [];
33
- sources.push({ file, text: bytes.subarray(start, next).toString('utf8') });
34
- cursor = next + 1;
35
- }
36
- return sources;
37
- }
38
- catch {
39
- // A non-git fixture (or an unavailable index) still uses the existing filesystem consumers.
40
- return [];
41
- }
42
- }