@starci/eslint-canon-be 3.8.19 → 3.9.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 (164) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/package.json +1 -1
  3. package/runtime/bundle.json +192 -0
  4. package/runtime/engine/by-code-unit.mjs +6 -6
  5. package/runtime/engine/model-config.mjs +98 -76
  6. package/runtime/engine/orca-config.mjs +22 -17
  7. package/runtime/engine/release-config.mjs +22 -18
  8. package/runtime/engine/removed-vocabulary.mjs +21 -20
  9. package/runtime/engine/resources-config.mjs +42 -35
  10. package/runtime/engine/runtime-root.mjs +11 -13
  11. package/runtime/engine/secrets.mjs +170 -102
  12. package/runtime/engine/sonar-config.mjs +16 -13
  13. package/runtime/engine/temp-root.mjs +3 -9
  14. package/runtime/knowledge/hfs/canon-pins.yaml +10 -10
  15. package/runtime/knowledge/hfs/rules.yaml +6 -6
  16. package/runtime/knowledge/hfs/slots.yaml +2 -2
  17. package/runtime/knowledge/sonar-gate.yaml +1 -1
  18. package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -1
  19. package/runtime/scripts/api/git/cat-file.mjs +0 -1
  20. package/runtime/scripts/api/git/config-get.mjs +1 -2
  21. package/runtime/scripts/api/git/diff.mjs +0 -1
  22. package/runtime/scripts/api/git/lib.mjs +32 -32
  23. package/runtime/scripts/api/git/ls-files.mjs +0 -1
  24. package/runtime/scripts/api/git/ls-tree.mjs +0 -1
  25. package/runtime/scripts/api/git/merge-base.mjs +2 -3
  26. package/runtime/scripts/api/git/remote.mjs +0 -1
  27. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -1
  28. package/runtime/scripts/api/git/show.mjs +0 -1
  29. package/runtime/scripts/hfs/allows.mjs +37 -38
  30. package/runtime/scripts/hfs/architecture/ast-walks.mjs +180 -163
  31. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +80 -73
  32. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +88 -77
  33. package/runtime/scripts/hfs/architecture/backend.mjs +378 -357
  34. package/runtime/scripts/hfs/architecture/background-unowned.mjs +201 -187
  35. package/runtime/scripts/hfs/architecture/canon-clones.mjs +260 -209
  36. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +149 -116
  37. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +72 -68
  38. package/runtime/scripts/hfs/architecture/clones.mjs +212 -217
  39. package/runtime/scripts/hfs/architecture/config-unread.mjs +7 -9
  40. package/runtime/scripts/hfs/architecture/config.mjs +302 -268
  41. package/runtime/scripts/hfs/architecture/connection-map.mjs +258 -225
  42. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +80 -71
  43. package/runtime/scripts/hfs/architecture/context-coupling.mjs +82 -77
  44. package/runtime/scripts/hfs/architecture/context-map.mjs +267 -234
  45. package/runtime/scripts/hfs/architecture/context-owner.mjs +73 -61
  46. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +47 -43
  47. package/runtime/scripts/hfs/architecture/context-transaction.mjs +54 -52
  48. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +113 -104
  49. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +288 -270
  50. package/runtime/scripts/hfs/architecture/contracts.mjs +408 -393
  51. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +50 -51
  52. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +143 -119
  53. package/runtime/scripts/hfs/architecture/dead-exports.mjs +286 -228
  54. package/runtime/scripts/hfs/architecture/default-deny.mjs +129 -110
  55. package/runtime/scripts/hfs/architecture/doc-language.mjs +24 -19
  56. package/runtime/scripts/hfs/architecture/entity-registry.mjs +20 -22
  57. package/runtime/scripts/hfs/architecture/entrypoint.mjs +47 -45
  58. package/runtime/scripts/hfs/architecture/error-codes.mjs +37 -35
  59. package/runtime/scripts/hfs/architecture/error-masked.mjs +55 -59
  60. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +24 -23
  61. package/runtime/scripts/hfs/architecture/feature-shape.mjs +40 -38
  62. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +21 -21
  63. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +106 -98
  64. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +153 -150
  65. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +161 -149
  66. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +343 -305
  67. package/runtime/scripts/hfs/architecture/frontend-world.mjs +340 -294
  68. package/runtime/scripts/hfs/architecture/frontend.mjs +174 -184
  69. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +124 -106
  70. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +52 -48
  71. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +81 -71
  72. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +155 -141
  73. package/runtime/scripts/hfs/architecture/identity.mjs +141 -125
  74. package/runtime/scripts/hfs/architecture/index.mjs +272 -272
  75. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +45 -43
  76. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +195 -176
  77. package/runtime/scripts/hfs/architecture/machine-ast.mjs +163 -155
  78. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +19 -20
  79. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +177 -172
  80. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +100 -78
  81. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +170 -154
  82. package/runtime/scripts/hfs/architecture/next-data-key.mjs +311 -275
  83. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +17 -17
  84. package/runtime/scripts/hfs/architecture/next-data.mjs +351 -334
  85. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +39 -37
  86. package/runtime/scripts/hfs/architecture/owners.mjs +97 -98
  87. package/runtime/scripts/hfs/architecture/package-shape.mjs +56 -55
  88. package/runtime/scripts/hfs/architecture/presentation.mjs +138 -130
  89. package/runtime/scripts/hfs/architecture/reachability.mjs +258 -241
  90. package/runtime/scripts/hfs/architecture/register-once.mjs +152 -139
  91. package/runtime/scripts/hfs/architecture/registration.mjs +301 -267
  92. package/runtime/scripts/hfs/architecture/required-files.mjs +172 -167
  93. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +85 -77
  94. package/runtime/scripts/hfs/architecture/schema-owner.mjs +206 -181
  95. package/runtime/scripts/hfs/architecture/server-action.mjs +48 -48
  96. package/runtime/scripts/hfs/architecture/side-boundary.mjs +2 -5
  97. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +261 -259
  98. package/runtime/scripts/hfs/architecture/source-names.mjs +304 -278
  99. package/runtime/scripts/hfs/architecture/sql-keys.mjs +277 -194
  100. package/runtime/scripts/hfs/architecture/sql-owner.mjs +236 -194
  101. package/runtime/scripts/hfs/architecture/sql-returning.mjs +46 -45
  102. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +86 -74
  103. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +456 -341
  104. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +35 -30
  105. package/runtime/scripts/hfs/architecture/surface.mjs +64 -74
  106. package/runtime/scripts/hfs/architecture/symbols.mjs +209 -216
  107. package/runtime/scripts/hfs/architecture/test-world-files.mjs +165 -155
  108. package/runtime/scripts/hfs/architecture/tiers.mjs +161 -154
  109. package/runtime/scripts/hfs/architecture/transport-owner.mjs +155 -149
  110. package/runtime/scripts/hfs/architecture/type-context.mjs +255 -250
  111. package/runtime/scripts/hfs/architecture/typescript.mjs +358 -318
  112. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +110 -92
  113. package/runtime/scripts/hfs/declaration-shape.mjs +140 -103
  114. package/runtime/scripts/hfs/declaration-slots.mjs +64 -61
  115. package/runtime/scripts/hfs/edition-slots.mjs +43 -40
  116. package/runtime/scripts/hfs/linear-text.mjs +20 -20
  117. package/runtime/scripts/hfs/param-names.mjs +6 -11
  118. package/runtime/scripts/hfs/path-findings.mjs +120 -100
  119. package/runtime/scripts/hfs/repo-identity.mjs +55 -42
  120. package/runtime/scripts/hfs/rule-catalog.mjs +353 -257
  121. package/runtime/scripts/hfs/rule-params-shape.mjs +60 -47
  122. package/runtime/scripts/hfs/rules/database-migrations.mjs +428 -388
  123. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +37 -36
  124. package/runtime/scripts/hfs/rules/read.mjs +19 -15
  125. package/runtime/scripts/hfs/rules/secrets.mjs +1 -1
  126. package/runtime/scripts/hfs/rules/spec-placement.mjs +12 -13
  127. package/runtime/scripts/hfs/slot-app-view.mjs +69 -74
  128. package/runtime/scripts/hfs/slot-classify.mjs +42 -38
  129. package/runtime/scripts/hfs/slot-errors.mjs +8 -7
  130. package/runtime/scripts/hfs/slot-imports.mjs +70 -63
  131. package/runtime/scripts/hfs/slot-manifest-shape.mjs +74 -52
  132. package/runtime/scripts/hfs/slot-match.mjs +122 -111
  133. package/runtime/scripts/hfs/slot-path.mjs +0 -2
  134. package/runtime/scripts/hfs/slot-required.mjs +65 -59
  135. package/runtime/scripts/hfs/slot-semantic-problems.mjs +138 -112
  136. package/runtime/scripts/hfs/slot-side-problems.mjs +23 -19
  137. package/runtime/scripts/hfs/slots.mjs +175 -152
  138. package/runtime/scripts/hfs/test-world-slot.mjs +0 -1
  139. package/runtime/scripts/hfs/trailing-slashes.mjs +4 -4
  140. package/runtime/scripts/hfs/typescript-programs.mjs +66 -69
  141. package/runtime/scripts/hfs/view.mjs +38 -40
  142. package/runtime/scripts/lib/dockerfile.mjs +131 -114
  143. package/runtime/scripts/lib/env.mjs +3 -6
  144. package/runtime/scripts/lib/event-contract.mjs +73 -78
  145. package/runtime/scripts/lib/git.mjs +15 -16
  146. package/runtime/scripts/lib/glob.mjs +23 -14
  147. package/runtime/scripts/lib/grammar-lint.mjs +33 -37
  148. package/runtime/scripts/lib/i18n.mjs +32 -35
  149. package/runtime/scripts/lib/in-order.mjs +57 -38
  150. package/runtime/scripts/lib/json-clone.mjs +45 -36
  151. package/runtime/scripts/lib/json.mjs +26 -14
  152. package/runtime/scripts/lib/language.mjs +133 -129
  153. package/runtime/scripts/lib/list.mjs +9 -14
  154. package/runtime/scripts/lib/mutation-fence.mjs +10 -5
  155. package/runtime/scripts/lib/path-key.mjs +53 -38
  156. package/runtime/scripts/lib/read-text.mjs +30 -17
  157. package/runtime/scripts/lib/regex.mjs +1 -2
  158. package/runtime/scripts/lib/same-text.mjs +0 -1
  159. package/runtime/scripts/lib/sops-envelope.mjs +148 -120
  160. package/runtime/scripts/lib/stack-services.mjs +128 -129
  161. package/runtime/scripts/lib/ts-analysis.mjs +28 -26
  162. package/runtime/scripts/lib/ts-ast.mjs +36 -42
  163. package/runtime/scripts/lib/walk.mjs +33 -27
  164. package/runtime/scripts/lib/yaml-cached.mjs +4 -4
@@ -4,12 +4,11 @@ import { relativePath, unwrapExpression } from './typescript.mjs';
4
4
  import { commonJsRequireReasons, constructedDecoratorKind, decoratorCallee, moduleExportsOf, mutableDecoratorKind, nodeDecorators, normalizedSymbol, normalizedSymbolValue, programSourcesOf, returnedExpressions, selectedNode, valueSymbol, violation } from './ast-walks.mjs';
5
5
  import { createBackendSourceShapeChecker } from './source-names-shape.mjs';
6
6
  import { byCodeUnit } from '../../lib/list.mjs';
7
-
8
7
  const SOURCE_LAYOUT_RULE_ID = 'BE_FEATURE_LAYOUT_INVALID';
9
8
  const SOURCE_NAME_RULE_ID = 'BE_SOURCE_FORM';
10
9
  const FRAMEWORK_EXPORTS = new Map([
11
- ['@nestjs/graphql', new Set(['Args', 'ArgsType', 'InputType', 'Mutation', 'ObjectType', 'Query', 'Subscription', 'registerEnumType'])],
12
- ['typeorm', new Set(['Entity', 'EntitySchema', 'MigrationInterface', 'ViewEntity'])],
10
+ ['@nestjs/graphql', new Set(['Args', 'ArgsType', 'InputType', 'Mutation', 'ObjectType', 'Query', 'Subscription', 'registerEnumType'])],
11
+ ['typeorm', new Set(['Entity', 'EntitySchema', 'MigrationInterface', 'ViewEntity'])],
13
12
  ]);
14
13
  const APPLICATION_ROLES = new Set(['command', 'contracts', 'handler', 'query']);
15
14
  const TRANSPORT_ROLES = new Set(['args', 'cli', 'consumer', 'controller', 'gateway', 'input', 'processor', 'request', 'resolver', 'response', 'type']);
@@ -18,16 +17,16 @@ const TRANSPORT_LAYER_ROLES = new Set([...TRANSPORT_ROLES, 'enum', 'filter', 'gu
18
17
  // Class-bearing roles of the CLOSED suffix list of BE-CONVENTION 1.15 (class name = PascalCase of file + role). A role that is
19
18
  // not in that list (adapter, exception, provider, repository, strategy, use-case) is never an allowed role here.
20
19
  const CLASS_ROLE_SUFFIX = new Map([
21
- ['args', 'Args'], ['cli', 'Cli'], ['client', 'Client'], ['command', 'Command'], ['consumer', 'Consumer'],
22
- ['controller', 'Controller'], ['entity', 'Entity'], ['error', 'Error'], ['filter', 'Filter'], ['gateway', 'Gateway'],
23
- ['guard', 'Guard'], ['handler', 'Handler'], ['input', 'Input'], ['interceptor', 'Interceptor'], ['processor', 'Processor'], ['event', 'Event'], ['queue', 'Queue'],
24
- ['projection', 'Projection'], ['projection-entity', 'ProjectionEntity'], ['step', 'Step'], ['mapper', 'Mapper'], ['module', 'Module'], ['module-definition', 'Module'], ['policy', 'Policy'], ['query', 'Query'],
25
- ['request', 'Request'], ['resolver', 'Resolver'], ['response', 'Response'], ['service', 'Service'], ['type', 'Type'],
20
+ ['args', 'Args'], ['cli', 'Cli'], ['client', 'Client'], ['command', 'Command'], ['consumer', 'Consumer'],
21
+ ['controller', 'Controller'], ['entity', 'Entity'], ['error', 'Error'], ['filter', 'Filter'], ['gateway', 'Gateway'],
22
+ ['guard', 'Guard'], ['handler', 'Handler'], ['input', 'Input'], ['interceptor', 'Interceptor'], ['processor', 'Processor'], ['event', 'Event'], ['queue', 'Queue'],
23
+ ['projection', 'Projection'], ['projection-entity', 'ProjectionEntity'], ['step', 'Step'], ['mapper', 'Mapper'], ['module', 'Module'], ['module-definition', 'Module'], ['policy', 'Policy'], ['query', 'Query'],
24
+ ['request', 'Request'], ['resolver', 'Resolver'], ['response', 'Response'], ['service', 'Service'], ['type', 'Type'],
26
25
  ]);
27
26
  // Transport object contracts (interfaces and object aliases) named by their file role: <Action>Input in *.input.ts,
28
27
  // <Action>Request in *.request.ts, <Name>Row in *.rows.ts ... Domain values in *.contracts.ts and *.options.ts carry no suffix.
29
28
  const TRANSPORT_OBJECT_SUFFIX = new Map([
30
- ['args', 'Args'], ['input', 'Input'], ['request', 'Request'], ['response', 'Response'], ['rows', 'Row'], ['type', 'Type'],
29
+ ['args', 'Args'], ['input', 'Input'], ['request', 'Request'], ['response', 'Response'], ['rows', 'Row'], ['type', 'Type'],
31
30
  ]);
32
31
  // A class that implements an interface declared in a file with one of these roles may be named <Qualifier><InterfaceName>.
33
32
  const PORT_DECLARATION_ROLES = new Set(['contracts', 'port']);
@@ -36,332 +35,359 @@ const KNOWN_HYPHEN_ROLES = [...CLASS_ROLE_SUFFIX.keys()].sort((a, b) => b.length
36
35
  const SPECIAL_BASENAMES = new Set(['config', 'configuration', 'constants', 'decorators', 'env', 'environment', 'index', 'main', 'types']);
37
36
  const NO_PROGRAM_CHECKER = 'a TypeScript program checker could not be associated with its source';
38
37
  const SOURCE_EXTENSION = /\.[cm]?[jt]sx?$/i;
39
-
38
+ /** A node that carries a name (a declaration, a member, a parameter). */
39
+ const hasName = (node) => 'name' in node && Boolean(node.name);
40
+ /** The framework kind a symbol is bound to, or null. */
41
+ const kindOfSymbol = (targets, symbol) => (symbol ? targets.get(symbol) ?? null : null);
40
42
  function absoluteRoots(root, relatives) {
41
- return relatives.map(relative => path.resolve(root, ...relative.split('/')));
43
+ return relatives.map(relative => path.resolve(root, ...relative.split('/')));
42
44
  }
43
-
44
45
  function canonical(file) {
45
- return path.resolve(file);
46
+ return path.resolve(file);
46
47
  }
47
-
48
48
  function addFrameworkTargets(config, context, checker, sourceFile, statement, bySymbol, reasons) {
49
- const bound = moduleExportsOf(context.ts, checker, statement);
50
- if (!bound || !FRAMEWORK_EXPORTS.has(bound.specifier)) return;
51
- if (!bound.symbol) {
52
- reasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot resolve ${bound.specifier}`);
53
- return;
54
- }
55
- const selected = FRAMEWORK_EXPORTS.get(bound.specifier);
56
- for (const [name, target] of bound.exports) if (selected.has(name) && target) bySymbol.set(target, name);
57
- }
58
-
49
+ const bound = moduleExportsOf(context.ts, checker, statement);
50
+ const selected = bound ? FRAMEWORK_EXPORTS.get(bound.specifier) : undefined;
51
+ if (!bound || !selected)
52
+ return;
53
+ if (!bound.symbol) {
54
+ reasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot resolve ${bound.specifier}`);
55
+ return;
56
+ }
57
+ for (const [name, target] of bound.exports)
58
+ if (selected.has(name) && target)
59
+ bySymbol.set(target, name);
60
+ }
59
61
  function frameworkTargets(config, context, checker, localFiles) {
60
- const reasons = [];
61
- const bySymbol = new Map();
62
- const files = programSourcesOf(context, checker, localFiles);
63
- if (!files) return { bySymbol, reasons: [NO_PROGRAM_CHECKER] };
64
- for (const sourceFile of files) {
65
- for (const statement of sourceFile.statements) {
66
- addFrameworkTargets(config, context, checker, sourceFile, statement, bySymbol, reasons);
62
+ const reasons = [];
63
+ const bySymbol = new Map();
64
+ const files = programSourcesOf(context, checker, localFiles);
65
+ if (!files)
66
+ return { bySymbol, reasons: [NO_PROGRAM_CHECKER] };
67
+ for (const sourceFile of files) {
68
+ for (const statement of sourceFile.statements) {
69
+ addFrameworkTargets(config, context, checker, sourceFile, statement, bySymbol, reasons);
70
+ }
71
+ commonJsRequireReasons(context.ts, checker, sourceFile, (specifier) => FRAMEWORK_EXPORTS.has(specifier), reasons, relativePath(config.root, sourceFile.fileName), 'binding whose source role cannot be proved');
67
72
  }
68
- commonJsRequireReasons(context.ts, checker, sourceFile, (specifier) => FRAMEWORK_EXPORTS.has(specifier),
69
- reasons, relativePath(config.root, sourceFile.fileName), 'binding whose source role cannot be proved');
70
- }
71
- return { bySymbol, reasons };
73
+ return { bySymbol, reasons };
72
74
  }
73
-
74
75
  function decoratorKind(ts, checker, decorator, targets) {
75
- const selected = selectedNode(ts, decoratorCallee(ts, decorator));
76
- return selected ? targets.get(valueSymbol(ts, checker, selected)) ?? null : null;
76
+ const selected = selectedNode(ts, decoratorCallee(ts, decorator));
77
+ return selected ? kindOfSymbol(targets, valueSymbol(ts, checker, selected)) : null;
77
78
  }
78
-
79
79
  /* This module's trace descends `new X()` callees too; the framework map keys symbols directly. */
80
80
  const TRACE_NEW = { newExpression: true };
81
-
82
81
  function hasModifier(ts, node, kind) {
83
- return (ts.canHaveModifiers(node) ? ts.getModifiers(node) ?? [] : node.modifiers ?? []).some(modifier => modifier.kind === kind);
82
+ // a TypeScript older than canHaveModifiers keeps the modifiers on the node itself
83
+ return (ts.canHaveModifiers(node) ? ts.getModifiers(node) ?? [] : node.modifiers ?? []).some(modifier => modifier.kind === kind);
84
84
  }
85
-
86
-
87
-
88
85
  function sourceRole(ts, sourceFile) {
89
- const file = path.basename(sourceFile.fileName).replace(SOURCE_EXTENSION, '');
90
- const base = file.replace(/\.(?:int-)?spec$/i, '');
91
- const segments = base.split('.');
92
- if (segments.length > 1) return { base, role: segments.at(-1).toLowerCase(), spec: base !== file };
93
- const lower = base.toLowerCase();
94
- const known = KNOWN_HYPHEN_ROLES.find(role => lower === role || lower.endsWith(`-${role}`));
95
- if (known) return { base, role: known, spec: base !== file };
96
- const topLevel = sourceFile.statements;
97
- if (topLevel.some(statement => ts.isEnumDeclaration(statement))) return { base, role: 'enum', spec: base !== file };
98
- return { base, role: null, spec: base !== file };
99
- }
100
-
86
+ const file = path.basename(sourceFile.fileName).replace(SOURCE_EXTENSION, '');
87
+ const base = file.replace(/\.(?:int-)?spec$/i, '');
88
+ const segments = base.split('.');
89
+ if (segments.length > 1)
90
+ return { base, role: segments.at(-1)?.toLowerCase() ?? null, spec: base !== file };
91
+ const lower = base.toLowerCase();
92
+ const known = KNOWN_HYPHEN_ROLES.find(role => lower === role || lower.endsWith(`-${role}`));
93
+ if (known)
94
+ return { base, role: known, spec: base !== file };
95
+ const topLevel = sourceFile.statements;
96
+ if (topLevel.some(statement => ts.isEnumDeclaration(statement)))
97
+ return { base, role: 'enum', spec: base !== file };
98
+ return { base, role: null, spec: base !== file };
99
+ }
101
100
  function kebabSourceBase(base) {
102
- return /^[a-z0-9]+(?:-[a-z0-9]+)*(?:\.[a-z0-9]+(?:-[a-z0-9]+)*)*$/.test(base);
101
+ return /^[a-z0-9]+(?:-[a-z0-9]+)*(?:\.[a-z0-9]+(?:-[a-z0-9]+)*)*$/.test(base);
103
102
  }
104
-
105
103
  function exportedDeclarations(ts, checker, sourceFile) {
106
- const exported = new Set();
107
- const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
108
- for (const symbol of moduleSymbol ? checker.getExportsOfModule(moduleSymbol) : []) {
109
- const target = normalizedSymbolValue(ts, checker, symbol);
110
- for (const declaration of target?.getDeclarations?.() ?? []) if (declaration.getSourceFile() === sourceFile) exported.add(declaration);
111
- }
112
- return exported;
113
- }
114
-
104
+ const exported = new Set();
105
+ const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
106
+ for (const symbol of moduleSymbol ? checker.getExportsOfModule(moduleSymbol) : []) {
107
+ const target = normalizedSymbolValue(ts, checker, symbol);
108
+ for (const declaration of target?.getDeclarations?.() ?? [])
109
+ if (declaration.getSourceFile() === sourceFile)
110
+ exported.add(declaration);
111
+ }
112
+ return exported;
113
+ }
115
114
  function combineClassValue(results) {
116
- if (results.some(result => result.status === 'unavailable')) return { status: 'unavailable', names: [] };
117
- const classes = results.filter(result => result.status === 'class');
118
- if (!classes.length) return { status: 'not-class', names: [] };
119
- if (classes.length !== results.length) return { status: 'unavailable', names: [] };
120
- return { status: 'class', names: [...new Set(classes.flatMap(result => result.names))] };
115
+ if (results.some(result => result.status === 'unavailable'))
116
+ return { status: 'unavailable', names: [] };
117
+ const classes = results.filter(result => result.status === 'class');
118
+ if (!classes.length)
119
+ return { status: 'not-class', names: [] };
120
+ if (classes.length !== results.length)
121
+ return { status: 'unavailable', names: [] };
122
+ return { status: 'class', names: [...new Set(classes.flatMap(result => result.names))] };
121
123
  }
122
-
123
124
  function pushReturnedClassStatuses(ts, checker, results, container, nextSeen, depth) {
124
- for (const returned of returnedExpressions(ts, container)) results.push(classValueStatus(ts, checker, returned, nextSeen, depth + 1));
125
+ for (const returned of returnedExpressions(ts, container))
126
+ results.push(classValueStatus(ts, checker, returned, nextSeen, depth + 1));
125
127
  }
126
-
127
128
  function classDeclarationResults(ts, checker, expression, declaration, nextSeen, depth) {
128
- const results = [];
129
- if (ts.isClassDeclaration(declaration)) results.push({ status: 'class', names: declaration.name ? [declaration.name.text] : [] });
130
- if (ts.isVariableDeclaration(declaration) && declaration.initializer) {
131
- if (ts.isCallExpression(expression)
132
- && (ts.isArrowFunction(declaration.initializer) || ts.isFunctionExpression(declaration.initializer))) {
133
- pushReturnedClassStatuses(ts, checker, results, declaration.initializer, nextSeen, depth);
134
- } else results.push(classValueStatus(ts, checker, declaration.initializer, nextSeen, depth + 1));
135
- }
136
- if (ts.isCallExpression(expression)) pushReturnedClassStatuses(ts, checker, results, declaration, nextSeen, depth);
137
- return results;
138
- }
139
-
129
+ const results = [];
130
+ if (ts.isClassDeclaration(declaration))
131
+ results.push({ status: 'class', names: declaration.name ? [declaration.name.text] : [] });
132
+ if (ts.isVariableDeclaration(declaration) && declaration.initializer) {
133
+ if (ts.isCallExpression(expression)
134
+ && (ts.isArrowFunction(declaration.initializer) || ts.isFunctionExpression(declaration.initializer))) {
135
+ pushReturnedClassStatuses(ts, checker, results, declaration.initializer, nextSeen, depth);
136
+ }
137
+ else
138
+ results.push(classValueStatus(ts, checker, declaration.initializer, nextSeen, depth + 1));
139
+ }
140
+ if (ts.isCallExpression(expression))
141
+ pushReturnedClassStatuses(ts, checker, results, declaration, nextSeen, depth);
142
+ return results;
143
+ }
140
144
  function classSymbolStatus(ts, checker, expression, seen, depth) {
141
- const selected = selectedNode(ts, ts.isCallExpression(expression) ? expression.expression : expression);
142
- const symbol = selected ? normalizedSymbol(ts, checker, selected) : null;
143
- if (!symbol || seen.has(symbol)) return { status: 'not-class', names: [] };
144
- const nextSeen = new Set(seen).add(symbol);
145
- const results = [];
146
- for (const declaration of symbol.getDeclarations?.() ?? []) results.push(...classDeclarationResults(ts, checker, expression, declaration, nextSeen, depth));
147
- return results.length ? combineClassValue(results) : { status: 'not-class', names: [] };
148
- }
149
-
145
+ const selected = selectedNode(ts, ts.isCallExpression(expression) ? expression.expression : expression);
146
+ const symbol = selected ? normalizedSymbol(ts, checker, selected) : null;
147
+ if (!symbol || seen.has(symbol))
148
+ return { status: 'not-class', names: [] };
149
+ const nextSeen = new Set(seen).add(symbol);
150
+ const results = [];
151
+ for (const declaration of symbol.getDeclarations?.() ?? [])
152
+ results.push(...classDeclarationResults(ts, checker, expression, declaration, nextSeen, depth));
153
+ return results.length ? combineClassValue(results) : { status: 'not-class', names: [] };
154
+ }
150
155
  function classValueStatus(ts, checker, expression, seen = new Set(), depth = 0) {
151
- if (!expression) return { status: 'not-class', names: [] };
152
- if (depth > 10) return { status: 'unavailable', names: [] };
153
- expression = unwrapExpression(ts, expression);
154
- if (ts.isClassExpression(expression)) return { status: 'class', names: expression.name ? [expression.name.text] : [] };
155
- if (ts.isConditionalExpression(expression)) return combineClassValue([
156
- classValueStatus(ts, checker, expression.whenTrue, seen, depth + 1),
157
- classValueStatus(ts, checker, expression.whenFalse, seen, depth + 1),
158
- ]);
159
- return classSymbolStatus(ts, checker, expression, seen, depth);
160
- }
161
-
156
+ if (!expression)
157
+ return { status: 'not-class', names: [] };
158
+ if (depth > 10)
159
+ return { status: 'unavailable', names: [] };
160
+ const unwrapped = unwrapExpression(ts, expression);
161
+ if (ts.isClassExpression(unwrapped))
162
+ return { status: 'class', names: unwrapped.name ? [unwrapped.name.text] : [] };
163
+ if (ts.isConditionalExpression(unwrapped))
164
+ return combineClassValue([
165
+ classValueStatus(ts, checker, unwrapped.whenTrue, seen, depth + 1),
166
+ classValueStatus(ts, checker, unwrapped.whenFalse, seen, depth + 1),
167
+ ]);
168
+ return classSymbolStatus(ts, checker, unwrapped, seen, depth);
169
+ }
162
170
  function combineObjectStatus(statuses) {
163
- if (statuses.includes('object')) return 'object';
164
- if (statuses.includes('unavailable')) return 'unavailable';
165
- return 'not-object';
171
+ if (statuses.includes('object'))
172
+ return 'object';
173
+ if (statuses.includes('unavailable'))
174
+ return 'unavailable';
175
+ return 'not-object';
166
176
  }
167
-
168
177
  function declarationObjectStatus(ts, checker, declaration, seen, depth) {
169
- if (ts.isInterfaceDeclaration(declaration)) return 'object';
170
- if (ts.isTypeAliasDeclaration(declaration)) return objectTypeStatus(ts, checker, declaration.type, seen, depth + 1);
171
- if (ts.isTypeParameterDeclaration(declaration) || ts.isClassDeclaration(declaration)) return 'unavailable';
172
- return 'not-object';
178
+ if (ts.isInterfaceDeclaration(declaration))
179
+ return 'object';
180
+ if (ts.isTypeAliasDeclaration(declaration))
181
+ return objectTypeStatus(ts, checker, declaration.type, seen, depth + 1);
182
+ if (ts.isTypeParameterDeclaration(declaration) || ts.isClassDeclaration(declaration))
183
+ return 'unavailable';
184
+ return 'not-object';
173
185
  }
174
-
175
186
  function typeReferenceStatus(ts, checker, node, seen, depth) {
176
- const symbol = normalizedSymbol(ts, checker, node.typeName);
177
- if (!symbol || seen.has(symbol)) return 'unavailable';
178
- const nextSeen = new Set(seen).add(symbol);
179
- const declarations = symbol.getDeclarations?.() ?? [];
180
- if (!declarations.length) return 'unavailable';
181
- return combineObjectStatus(declarations.map(declaration => declarationObjectStatus(ts, checker, declaration, nextSeen, depth)));
182
- }
183
-
187
+ const symbol = normalizedSymbol(ts, checker, node.typeName);
188
+ if (!symbol || seen.has(symbol))
189
+ return 'unavailable';
190
+ const nextSeen = new Set(seen).add(symbol);
191
+ const declarations = symbol.getDeclarations?.() ?? [];
192
+ if (!declarations.length)
193
+ return 'unavailable';
194
+ return combineObjectStatus(declarations.map(declaration => declarationObjectStatus(ts, checker, declaration, nextSeen, depth)));
195
+ }
184
196
  function objectTypeStatus(ts, checker, node, seen = new Set(), depth = 0) {
185
- if (!node || depth > 12) return 'unavailable';
186
- if (ts.isTypeLiteralNode(node) || ts.isMappedTypeNode(node)) return 'object';
187
- if (ts.isParenthesizedTypeNode(node)) return objectTypeStatus(ts, checker, node.type, seen, depth + 1);
188
- if (ts.isIntersectionTypeNode(node) || ts.isUnionTypeNode(node)) {
189
- return combineObjectStatus(node.types.map(type => objectTypeStatus(ts, checker, type, seen, depth + 1)));
190
- }
191
- if (ts.isTypeReferenceNode(node)) return typeReferenceStatus(ts, checker, node, seen, depth);
192
- if (ts.isConditionalTypeNode(node) || ts.isIndexedAccessTypeNode(node) || ts.isInferTypeNode(node) || ts.isTypeQueryNode(node)) return 'unavailable';
193
- return 'not-object';
194
- }
195
-
197
+ if (!node || depth > 12)
198
+ return 'unavailable';
199
+ if (ts.isTypeLiteralNode(node) || ts.isMappedTypeNode(node))
200
+ return 'object';
201
+ if (ts.isParenthesizedTypeNode(node))
202
+ return objectTypeStatus(ts, checker, node.type, seen, depth + 1);
203
+ if (ts.isIntersectionTypeNode(node) || ts.isUnionTypeNode(node)) {
204
+ return combineObjectStatus(node.types.map(type => objectTypeStatus(ts, checker, type, seen, depth + 1)));
205
+ }
206
+ if (ts.isTypeReferenceNode(node))
207
+ return typeReferenceStatus(ts, checker, node, seen, depth);
208
+ if (ts.isConditionalTypeNode(node) || ts.isIndexedAccessTypeNode(node) || ts.isInferTypeNode(node) || ts.isTypeQueryNode(node))
209
+ return 'unavailable';
210
+ return 'not-object';
211
+ }
196
212
  function objectContractStatus(ts, checker, node) {
197
- if (ts.isInterfaceDeclaration(node)) return 'object';
198
- return ts.isTypeAliasDeclaration(node) ? objectTypeStatus(ts, checker, node.type) : 'not-object';
213
+ if (ts.isInterfaceDeclaration(node))
214
+ return 'object';
215
+ return ts.isTypeAliasDeclaration(node) ? objectTypeStatus(ts, checker, node.type) : 'not-object';
199
216
  }
200
-
201
217
  function companionInterfaceAllowed(ts, sourceFile, name) {
202
- if (!/^I[A-Z]/.test(name)) return false;
203
- const companion = name.slice(1);
204
- return sourceFile.statements.some(statement => ts.isClassDeclaration(statement) && statement.name?.text === companion
205
- && nodeDecorators(ts, statement).length > 0);
218
+ if (!/^I[A-Z]/.test(name))
219
+ return false;
220
+ const companion = name.slice(1);
221
+ return sourceFile.statements.some(statement => ts.isClassDeclaration(statement) && statement.name?.text === companion
222
+ && nodeDecorators(ts, statement).length > 0);
206
223
  }
207
-
208
224
  function camelCase(value) {
209
- return /^[a-z][A-Za-z0-9]*$/.test(value);
225
+ return /^[a-z][A-Za-z0-9]*$/.test(value);
210
226
  }
211
-
212
227
  function staticProperty(ts, object, name) {
213
- if (!ts.isObjectLiteralExpression(object)) return { status: 'dynamic' };
214
- const matching = object.properties.filter(property => {
215
- if (!property.name) return false;
216
- if (ts.isIdentifier(property.name) || ts.isStringLiteralLike(property.name)) return property.name.text === name;
217
- return false;
218
- });
219
- if (!matching.length) return { status: 'missing' };
220
- if (matching.length !== 1 || !ts.isPropertyAssignment(matching[0])) return { status: 'dynamic', node: matching[0] };
221
- const initializer = unwrapExpression(ts, matching[0].initializer);
222
- return ts.isStringLiteralLike(initializer)
223
- ? { status: 'literal', value: initializer.text, node: initializer }
224
- : { status: 'dynamic', node: matching[0].initializer };
225
- }
226
-
228
+ if (!ts.isObjectLiteralExpression(object))
229
+ return { status: 'dynamic' };
230
+ const matching = object.properties.filter(property => {
231
+ if (!property.name)
232
+ return false;
233
+ if (ts.isIdentifier(property.name) || ts.isStringLiteralLike(property.name))
234
+ return property.name.text === name;
235
+ return false;
236
+ });
237
+ if (!matching.length)
238
+ return { status: 'missing' };
239
+ const [only] = matching;
240
+ if (matching.length !== 1 || !only || !ts.isPropertyAssignment(only))
241
+ return { status: 'dynamic', node: only };
242
+ const initializer = unwrapExpression(ts, only.initializer);
243
+ return ts.isStringLiteralLike(initializer)
244
+ ? { status: 'literal', value: initializer.text, node: initializer }
245
+ : { status: 'dynamic', node: only.initializer };
246
+ }
227
247
  function graphqlField({ config, context, sourceFile, node, decorator, kind, namingReasons, violations }) {
228
- const call = decorator.expression;
229
- if (!context.ts.isCallExpression(call)) {
230
- namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a non-call @${kind} decorator`);
231
- return;
232
- }
233
- const options = call.arguments.find(argument => context.ts.isObjectLiteralExpression(unwrapExpression(context.ts, argument)));
234
- const selected = options ? staticProperty(context.ts, unwrapExpression(context.ts, options), 'name') : { status: 'missing' };
235
- if (selected.status === 'dynamic') {
236
- namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a dynamic @${kind} field name`);
237
- return;
238
- }
239
- const methodName = node.name && (context.ts.isIdentifier(node.name) || context.ts.isStringLiteralLike(node.name)) ? node.name.text : null;
240
- const name = selected.status === 'literal' ? selected.value : methodName;
241
- if (selected.status === 'literal') {
242
- if (!methodName) namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the @${kind} method name`);
243
- else if (selected.value !== methodName) violations.push(violation(config, sourceFile, selected.node, SOURCE_NAME_RULE_ID,
244
- `GraphQL @${kind} field name ${selected.value} must equal its method name ${methodName}.`));
245
- }
246
- if (!name) namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the @${kind} field name`);
247
- else if (!camelCase(name)) violations.push(violation(config, sourceFile, selected.node ?? node.name ?? node, SOURCE_NAME_RULE_ID,
248
- `GraphQL field name ${name} must be camelCase.`));
249
- }
250
-
251
- function graphqlArgument(config, context, sourceFile, node, decorator, namingReasons, violations) {
252
- const call = decorator.expression;
253
- if (!context.ts.isCallExpression(call) || call.arguments.length === 0) {
254
- namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the @Args input name`);
255
- return;
256
- }
257
- const selected = unwrapExpression(context.ts, call.arguments[0]);
258
- if (!context.ts.isStringLiteralLike(selected)) {
259
- namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a dynamic @Args input name`);
260
- } else if (selected.text !== 'input') violations.push(violation(config, sourceFile, selected, SOURCE_NAME_RULE_ID,
261
- 'GraphQL request arguments use the literal name input.'));
262
- }
263
-
248
+ const call = decorator.expression;
249
+ if (!context.ts.isCallExpression(call)) {
250
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a non-call @${kind} decorator`);
251
+ return;
252
+ }
253
+ const options = call.arguments.find(argument => context.ts.isObjectLiteralExpression(unwrapExpression(context.ts, argument)));
254
+ const selected = options ? staticProperty(context.ts, unwrapExpression(context.ts, options), 'name') : { status: 'missing' };
255
+ if (selected.status === 'dynamic') {
256
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a dynamic @${kind} field name`);
257
+ return;
258
+ }
259
+ const declaredName = hasName(node) ? node.name : undefined;
260
+ const methodName = declaredName && (context.ts.isIdentifier(declaredName) || context.ts.isStringLiteralLike(declaredName)) ? declaredName.text : null;
261
+ const name = selected.status === 'literal' ? selected.value : methodName;
262
+ if (selected.status === 'literal') {
263
+ if (!methodName)
264
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the @${kind} method name`);
265
+ else if (selected.value !== methodName)
266
+ violations.push(violation(config, sourceFile, selected.node ?? node, SOURCE_NAME_RULE_ID, `GraphQL @${kind} field name ${selected.value} must equal its method name ${methodName}.`));
267
+ }
268
+ if (!name)
269
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the @${kind} field name`);
270
+ else if (!camelCase(name))
271
+ violations.push(violation(config, sourceFile, selected.node ?? declaredName ?? node, SOURCE_NAME_RULE_ID, `GraphQL field name ${name} must be camelCase.`));
272
+ }
273
+ function graphqlArgument(config, context, sourceFile, _node, decorator, namingReasons, violations) {
274
+ const call = decorator.expression;
275
+ const [argument] = context.ts.isCallExpression(call) ? call.arguments : [];
276
+ if (!context.ts.isCallExpression(call) || !argument) {
277
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the @Args input name`);
278
+ return;
279
+ }
280
+ const selected = unwrapExpression(context.ts, argument);
281
+ if (!context.ts.isStringLiteralLike(selected)) {
282
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a dynamic @Args input name`);
283
+ }
284
+ else if (selected.text !== 'input')
285
+ violations.push(violation(config, sourceFile, selected, SOURCE_NAME_RULE_ID, 'GraphQL request arguments use the literal name input.'));
286
+ }
264
287
  function graphqlEnumRegistration(config, context, sourceFile, call, namingReasons, violations) {
265
- if (call.arguments.length < 2) {
266
- namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the registered GraphQL enum name`);
267
- return;
268
- }
269
- const selected = staticProperty(context.ts, unwrapExpression(context.ts, call.arguments[1]), 'name');
270
- if (selected.status !== 'literal') namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a dynamic registered GraphQL enum name`);
271
- else if (!/^[A-Z][A-Za-z0-9]*$/.test(selected.value)) violations.push(violation(config, sourceFile, selected.node, SOURCE_NAME_RULE_ID,
272
- `Registered GraphQL enum name ${selected.value} must be PascalCase.`));
273
- }
274
-
288
+ const registration = call.arguments[1];
289
+ if (!registration) {
290
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot prove the registered GraphQL enum name`);
291
+ return;
292
+ }
293
+ const selected = staticProperty(context.ts, unwrapExpression(context.ts, registration), 'name');
294
+ if (selected.status !== 'literal')
295
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a dynamic registered GraphQL enum name`);
296
+ else if (!/^[A-Z][A-Za-z0-9]*$/.test(selected.value ?? ''))
297
+ violations.push(violation(config, sourceFile, selected.node ?? call, SOURCE_NAME_RULE_ID, `Registered GraphQL enum name ${selected.value} must be PascalCase.`));
298
+ }
275
299
  function selectedCallKind(ts, checker, call, targets) {
276
- const selected = selectedNode(ts, call.expression);
277
- return selected ? targets.get(valueSymbol(ts, checker, selected)) ?? null : null;
300
+ const selected = selectedNode(ts, call.expression);
301
+ return selected ? kindOfSymbol(targets, valueSymbol(ts, checker, selected)) : null;
278
302
  }
279
-
280
303
  function callsNamedHelper(ts, checker, call, name) {
281
- const selected = selectedNode(ts, call.expression);
282
- const symbol = selected ? normalizedSymbol(ts, checker, selected) : null;
283
- return (symbol?.getDeclarations?.() ?? []).some(declaration => {
284
- const declarationName = declaration.name;
285
- return declarationName && (ts.isIdentifier(declarationName) || ts.isStringLiteralLike(declarationName)) && declarationName.text === name;
286
- });
287
- }
288
-
304
+ const selected = selectedNode(ts, call.expression);
305
+ const symbol = selected ? normalizedSymbol(ts, checker, selected) : null;
306
+ return (symbol?.getDeclarations?.() ?? []).some(declaration => {
307
+ const declarationName = hasName(declaration) ? declaration.name : undefined;
308
+ return declarationName && (ts.isIdentifier(declarationName) || ts.isStringLiteralLike(declarationName)) && declarationName.text === name;
309
+ });
310
+ }
289
311
  function implementsFramework(ts, checker, declaration, targets, name) {
290
- return (declaration.heritageClauses ?? []).some(clause => clause.token === ts.SyntaxKind.ImplementsKeyword
291
- && clause.types.some(type => targets.get(valueSymbol(ts, checker, type.expression)) === name));
312
+ return (declaration.heritageClauses ?? []).some(clause => clause.token === ts.SyntaxKind.ImplementsKeyword
313
+ && clause.types.some(type => kindOfSymbol(targets, valueSymbol(ts, checker, type.expression)) === name));
292
314
  }
293
-
294
315
  /** Names of the interfaces a class implements that are declared in a *.port.ts or *.contracts.ts file (resolved by the type checker). */
295
316
  function portNamesForImplementedType(ts, checker, type) {
296
- const names = [];
297
- const symbol = normalizedSymbol(ts, checker, type.expression);
298
- for (const target of symbol?.getDeclarations?.() ?? []) {
299
- if (!ts.isInterfaceDeclaration(target) && !ts.isTypeAliasDeclaration(target)) continue;
300
- const declaredRole = path.basename(target.getSourceFile().fileName).replace(SOURCE_EXTENSION, '').split('.').at(-1);
301
- if (PORT_DECLARATION_ROLES.has(declaredRole)) names.push(target.name.text);
302
- }
303
- return names;
304
- }
305
-
317
+ const names = [];
318
+ const symbol = normalizedSymbol(ts, checker, type.expression);
319
+ for (const target of symbol?.getDeclarations?.() ?? []) {
320
+ if (!ts.isInterfaceDeclaration(target) && !ts.isTypeAliasDeclaration(target))
321
+ continue;
322
+ const declaredRole = path.basename(target.getSourceFile().fileName).replace(SOURCE_EXTENSION, '').split('.').at(-1);
323
+ if (declaredRole !== undefined && PORT_DECLARATION_ROLES.has(declaredRole))
324
+ names.push(target.name.text);
325
+ }
326
+ return names;
327
+ }
306
328
  function implementedPortNames(ts, checker, declaration) {
307
- return (declaration.heritageClauses ?? []).filter(clause => clause.token === ts.SyntaxKind.ImplementsKeyword)
308
- .flatMap(clause => clause.types.flatMap(type => portNamesForImplementedType(ts, checker, type)));
329
+ return (declaration.heritageClauses ?? []).filter(clause => clause.token === ts.SyntaxKind.ImplementsKeyword)
330
+ .flatMap(clause => clause.types.flatMap(type => portNamesForImplementedType(ts, checker, type)));
309
331
  }
310
-
311
332
  function locatedRoot(roots, fileName) {
312
- return roots.find(root => isInside(root, fileName)) ?? null;
333
+ return roots.find(root => isInside(root, fileName)) ?? null;
313
334
  }
314
-
315
335
  /** Check the adopted domain-first backend source layout without inferring semantic ownership from folder names alone. */
316
336
  const checkBackendSourceShapeImpl = createBackendSourceShapeChecker({
317
- absoluteRoots, canonical, frameworkTargets, locatedRoot, sourceRole, kebabSourceBase, exportedDeclarations,
318
- classValueStatus, objectContractStatus, companionInterfaceAllowed, hasModifier, graphqlField, graphqlArgument,
319
- graphqlEnumRegistration, selectedCallKind, callsNamedHelper, implementsFramework, implementedPortNames, decoratorKind,
320
- SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID, APPLICATION_ROLES, TRANSPORT_ROLES, APPLICATION_LAYER_ROLES,
321
- TRANSPORT_LAYER_ROLES, CLASS_ROLE_SUFFIX, TRANSPORT_OBJECT_SUFFIX, NON_CLASS_ROLES, SPECIAL_BASENAMES,
322
- TRACE_NEW,
337
+ absoluteRoots, canonical, frameworkTargets, locatedRoot, sourceRole, kebabSourceBase, exportedDeclarations,
338
+ classValueStatus, objectContractStatus, companionInterfaceAllowed, hasModifier, graphqlField, graphqlArgument,
339
+ graphqlEnumRegistration, selectedCallKind, callsNamedHelper, implementsFramework, implementedPortNames, decoratorKind,
340
+ SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID, APPLICATION_ROLES, TRANSPORT_ROLES, APPLICATION_LAYER_ROLES,
341
+ TRANSPORT_LAYER_ROLES, CLASS_ROLE_SUFFIX, TRANSPORT_OBJECT_SUFFIX, NON_CLASS_ROLES, SPECIAL_BASENAMES,
342
+ TRACE_NEW,
323
343
  });
324
-
325
344
  function inspectSubscriptionSource({ config, context, sourceFile, checker, framework, configuredRoot, namingReasons, violations }) {
326
- const visit = node => {
327
- for (const decorator of nodeDecorators(context.ts, node)) {
328
- const kind = decoratorKind(context.ts, checker, decorator, framework.bySymbol);
329
- if (kind === 'Subscription') graphqlField({ config, context, sourceFile, node, decorator, kind, namingReasons, violations });
330
- else if (!kind && !configuredRoot) {
331
- const dynamic = mutableDecoratorKind(context.ts, checker, decorator, framework.bySymbol)
332
- ?? constructedDecoratorKind(context.ts, checker, decorator, framework.bySymbol, TRACE_NEW);
333
- if (['Subscription', 'multiple framework', 'unproven framework'].includes(dynamic)) {
334
- namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} uses a mutable or constructed ${dynamic} decorator identity`);
345
+ const visit = (node) => {
346
+ for (const decorator of nodeDecorators(context.ts, node)) {
347
+ const kind = decoratorKind(context.ts, checker, decorator, framework.bySymbol);
348
+ if (kind === 'Subscription')
349
+ graphqlField({ config, context, sourceFile, node, decorator, kind, namingReasons, violations });
350
+ else if (!kind && !configuredRoot) {
351
+ const dynamic = mutableDecoratorKind(context.ts, checker, decorator, framework.bySymbol)
352
+ ?? constructedDecoratorKind(context.ts, checker, decorator, framework.bySymbol, TRACE_NEW);
353
+ if (dynamic !== null && ['Subscription', 'multiple framework', 'unproven framework'].includes(dynamic)) {
354
+ namingReasons.push(`${relativePath(config.root, sourceFile.fileName)} uses a mutable or constructed ${dynamic} decorator identity`);
355
+ }
356
+ }
335
357
  }
336
- }
337
- }
338
- context.ts.forEachChild(node, visit);
339
- };
340
- visit(sourceFile);
358
+ context.ts.forEachChild(node, visit);
359
+ };
360
+ visit(sourceFile);
341
361
  }
342
-
343
362
  export function checkBackendSourceShape(config, context) {
344
- const result = checkBackendSourceShapeImpl(config, context);
345
- const roots = absoluteRoots(config.root, [...config.backend.features, ...config.backend.modules]);
346
- const localFiles = new Set(context.files.map(file => canonical(file.fileName)));
347
- const frameworkByChecker = new Map();
348
- const namingReasons = [];
349
- // The shared shape walk dispatches Query and Mutation; subscriptions use the same naming relation here.
350
- for (const sourceFile of context.files) {
351
- const fileName = canonical(sourceFile.fileName);
352
- const configuredRoot = locatedRoot(roots, fileName);
353
- const owner = config.hfs?.ownerOf?.(relativePath(config.root, fileName));
354
- const slot = owner ? config.hfs.slot(owner.slot) : null;
355
- if (!configuredRoot && !(slot?.tier === 'feature' && slot.profiles?.includes('be'))) continue;
356
- const checker = context.checkerFor(fileName);
357
- if (!frameworkByChecker.has(checker)) frameworkByChecker.set(checker, frameworkTargets(config, context, checker, localFiles));
358
- const framework = frameworkByChecker.get(checker);
359
- inspectSubscriptionSource({ config, context, sourceFile, checker, framework, configuredRoot, namingReasons, violations: result.violations });
360
- }
361
- if (namingReasons.length) result.coverage.naming = {
362
- status: 'unavailable', reason: 'one or more backend source naming relations are not statically proved',
363
- details: [...new Set([...(result.coverage.naming.details ?? []), ...namingReasons])].sort(byCodeUnit),
364
- };
365
- return result;
363
+ const result = checkBackendSourceShapeImpl(config, context);
364
+ const roots = absoluteRoots(config.root, [...config.backend.features, ...config.backend.modules]);
365
+ const localFiles = new Set(context.files.map(file => canonical(file.fileName)));
366
+ const frameworkByChecker = new Map();
367
+ const namingReasons = [];
368
+ // The shared shape walk dispatches Query and Mutation; subscriptions use the same naming relation here.
369
+ for (const sourceFile of context.files) {
370
+ const fileName = canonical(sourceFile.fileName);
371
+ const configuredRoot = locatedRoot(roots, fileName);
372
+ const owner = config.hfs?.ownerOf?.(relativePath(config.root, fileName));
373
+ const slot = owner ? config.hfs.slot(owner.slot) : null;
374
+ if (!configuredRoot && !(slot?.tier === 'feature' && slot.profiles?.includes('be')))
375
+ continue;
376
+ const checker = context.checkerFor(fileName);
377
+ if (!checker)
378
+ continue;
379
+ let framework = frameworkByChecker.get(checker);
380
+ if (!framework) {
381
+ framework = frameworkTargets(config, context, checker, localFiles);
382
+ frameworkByChecker.set(checker, framework);
383
+ }
384
+ inspectSubscriptionSource({ config, context, sourceFile, checker, framework, configuredRoot, namingReasons, violations: result.violations });
385
+ }
386
+ if (namingReasons.length)
387
+ result.coverage.naming = {
388
+ status: 'unavailable', reason: 'one or more backend source naming relations are not statically proved',
389
+ details: [...new Set([...(result.coverage.naming.details ?? []), ...namingReasons])].sort(byCodeUnit),
390
+ };
391
+ return result;
366
392
  }
367
393
  export { SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID };