@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
@@ -7,465 +7,480 @@ import { hasAnyFlag } from '../../lib/ts-ast.mjs';
7
7
  import { canonical, checkInjectedClass, checkMessageReadonly, isPublicMember, messageClass } from './contracts-readonly.mjs';
8
8
  export const PUBLIC_CONTRACT_RULE_ID = 'BE_PUBLIC_CONTRACT_FORM';
9
9
  export { READONLY_BOUNDARY_RULE_ID } from './contracts-readonly.mjs';
10
-
11
10
  const FRAMEWORK_EXPORTS = new Map([
12
- ['@nestjs/common', new Set(['Controller', 'Inject', 'Injectable', 'Module'])],
13
- ['@nestjs/cqrs', new Set(['CommandHandler', 'QueryHandler'])],
14
- ['@nestjs/graphql', new Set(['Resolver'])],
11
+ ['@nestjs/common', new Set(['Controller', 'Inject', 'Injectable', 'Module'])],
12
+ ['@nestjs/cqrs', new Set(['CommandHandler', 'QueryHandler'])],
13
+ ['@nestjs/graphql', new Set(['Resolver'])],
15
14
  ]);
16
15
  const NEST_CREATED = new Set(['CommandHandler', 'Controller', 'Injectable', 'QueryHandler', 'Resolver']);
17
16
  const MESSAGE_HANDLERS = new Set(['CommandHandler', 'QueryHandler']);
18
17
  const NON_API_SOURCE_ROLES = new Set(['config', 'configuration', 'constants', 'main', 'module', 'module-definition', 'providers']);
19
18
  const SOURCE_EXTENSION = /\.[cm]?[jt]sx?$/i;
20
-
19
+ /** The checker of a file in the program; every file the contexts hand in belongs to one. */
20
+ const checkerFor = (context, fileName) => context.checkerFor(fileName);
21
21
  function frameworkKindForSymbol(symbol, targets) {
22
- const selected = targets.get(symbol);
23
- if (selected) return selected;
24
- const name = symbol?.getName?.();
25
- if (!name) return null;
26
- for (const [packageName, exports] of FRAMEWORK_EXPORTS) {
27
- if (!exports.has(name)) continue;
28
- const marker = `/node_modules/${packageName}/`;
29
- if ((symbol.getDeclarations?.() ?? []).some(declaration => declaration.getSourceFile().fileName.replaceAll('\\', '/').includes(marker))) return name;
30
- }
31
- return null;
32
- }
33
-
22
+ const selected = symbol ? targets.get(symbol) : undefined;
23
+ if (selected)
24
+ return selected;
25
+ const name = symbol?.getName?.();
26
+ if (!name)
27
+ return null;
28
+ for (const [packageName, exports] of FRAMEWORK_EXPORTS) {
29
+ if (!exports.has(name))
30
+ continue;
31
+ const marker = `/node_modules/${packageName}/`;
32
+ if ((symbol?.getDeclarations?.() ?? []).some((declaration) => declaration.getSourceFile().fileName.replaceAll('\\', '/').includes(marker)))
33
+ return name;
34
+ }
35
+ return null;
36
+ }
34
37
  /* This module's trace through frameworkKindForSymbol (name lookup and node_modules marker) instead of the
35
38
  * default symbol->kind map, plus the shorthand/property-assignment descent. */
36
39
  const FRAMEWORK_TRACE = {
37
- directOf: (ts, checker, { selected, targets }) => frameworkKindForSymbol(valueSymbol(ts, checker, selected), targets),
38
- shorthandOf: (ts, checker, target, targets) => frameworkKindForSymbol(target, targets),
40
+ directOf: (ts, checker, { selected, targets }) => frameworkKindForSymbol(valueSymbol(ts, checker, selected), targets),
41
+ shorthandOf: (_ts, _checker, target, targets) => frameworkKindForSymbol(target, targets),
39
42
  };
40
-
41
43
  function addFrameworkTargets(config, context, checker, sourceFile, statement, bySymbol, reasons) {
42
- const bound = moduleExportsOf(context.ts, checker, statement);
43
- if (!bound || !FRAMEWORK_EXPORTS.has(bound.specifier)) return;
44
- if (!bound.symbol) {
45
- reasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot resolve ${bound.specifier}`);
46
- return;
47
- }
48
- for (const name of referencedExports(context.ts, statement, FRAMEWORK_EXPORTS.get(bound.specifier))) {
49
- const target = bound.exports.get(name);
50
- if (target) bySymbol.set(target, name);
51
- else reasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot resolve ${name} from ${bound.specifier}`);
52
- }
53
- }
54
-
44
+ const bound = moduleExportsOf(context.ts, checker, statement);
45
+ if (!bound || !FRAMEWORK_EXPORTS.has(bound.specifier))
46
+ return;
47
+ if (!bound.symbol) {
48
+ reasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot resolve ${bound.specifier}`);
49
+ return;
50
+ }
51
+ for (const name of referencedExports(context.ts, statement, FRAMEWORK_EXPORTS.get(bound.specifier))) {
52
+ const target = bound.exports.get(name);
53
+ if (target)
54
+ bySymbol.set(target, name);
55
+ else
56
+ reasons.push(`${relativePath(config.root, sourceFile.fileName)} cannot resolve ${name} from ${bound.specifier}`);
57
+ }
58
+ }
55
59
  function frameworkTargets(config, context, checker, localFiles) {
56
- const bySymbol = new Map();
57
- const reasons = [];
58
- const files = programSourcesOf(context, checker, localFiles, { root: config.root });
59
- if (!files) return { bySymbol, reasons: ['a TypeScript program checker could not be associated with its source'] };
60
- for (const sourceFile of files) {
61
- for (const statement of sourceFile.statements) addFrameworkTargets(config, context, checker, sourceFile, statement, bySymbol, reasons);
62
- commonJsRequireReasons(context.ts, checker, sourceFile, specifier => FRAMEWORK_EXPORTS.has(specifier),
63
- reasons, relativePath(config.root, sourceFile.fileName), 'binding whose contract role cannot be proved');
64
- }
65
- return { bySymbol, reasons };
66
- }
67
-
60
+ const bySymbol = new Map();
61
+ const reasons = [];
62
+ const files = programSourcesOf(context, checker, localFiles, { root: config.root });
63
+ if (!files)
64
+ return { bySymbol, reasons: ['a TypeScript program checker could not be associated with its source'] };
65
+ for (const sourceFile of files) {
66
+ for (const statement of sourceFile.statements)
67
+ addFrameworkTargets(config, context, checker, sourceFile, statement, bySymbol, reasons);
68
+ commonJsRequireReasons(context.ts, checker, sourceFile, (specifier) => FRAMEWORK_EXPORTS.has(specifier), reasons, relativePath(config.root, sourceFile.fileName), 'binding whose contract role cannot be proved');
69
+ }
70
+ return { bySymbol, reasons };
71
+ }
68
72
  function decoratorKind(ts, checker, decorator, targets) {
69
- const selected = selectedNode(ts, decoratorCallee(ts, decorator));
70
- return selected ? frameworkKindForSymbol(valueSymbol(ts, checker, selected), targets) : null;
73
+ const selected = selectedNode(ts, decoratorCallee(ts, decorator));
74
+ return selected ? frameworkKindForSymbol(valueSymbol(ts, checker, selected), targets) : null;
71
75
  }
72
-
73
- const constructedDecoratorKind = (ts, checker, decorator, targets) =>
74
- sharedConstructedDecoratorKind(ts, checker, decorator, targets, FRAMEWORK_TRACE);
75
-
76
+ const constructedDecoratorKind = (ts, checker, decorator, targets) => sharedConstructedDecoratorKind(ts, checker, decorator, targets, FRAMEWORK_TRACE);
76
77
  function sourceRole(sourceFile) {
77
- const normalized = sourceFile.fileName.replaceAll('\\', '/');
78
- const base = path.basename(sourceFile.fileName).replace(SOURCE_EXTENSION, '').toLowerCase();
79
- const segments = base.split('.');
80
- const role = segments.length > 1 ? segments.at(-1) : ((base === 'use-case' || base.endsWith('-use-case')) && 'use-case') || null;
81
- return { base, role, transport: normalized.includes('/transport/') };
78
+ const normalized = sourceFile.fileName.replaceAll('\\', '/');
79
+ const base = path.basename(sourceFile.fileName).replace(SOURCE_EXTENSION, '').toLowerCase();
80
+ const segments = base.split('.');
81
+ const role = segments.length > 1 ? segments.at(-1) : ((base === 'use-case' || base.endsWith('-use-case')) && 'use-case') || null;
82
+ return { base, role, transport: normalized.includes('/transport/') };
82
83
  }
83
-
84
84
  function isFrameworkHelper(sourceFile, declaration, framework) {
85
- const role = sourceRole(sourceFile);
86
- if (role.transport || NON_API_SOURCE_ROLES.has(role.role) || NON_API_SOURCE_ROLES.has(role.base)) return true;
87
- if (declaration?.name && (declaration.name.text ?? '').endsWith('Module')) {
88
- return nodeDecorators(framework.ts, declaration).some(decorator => decoratorKind(framework.ts, framework.checker, decorator, framework.targets) === 'Module');
89
- }
90
- return false;
91
- }
92
-
93
- function builtinSymbol(ts, symbol, name) {
94
- if (!symbol || symbol.getName?.() !== name) return false;
95
- const declarations = symbol.getDeclarations?.() ?? [];
96
- return declarations.length > 0 && declarations.every(declaration => declaration.getSourceFile().isDeclarationFile
97
- && /(?:^|[/\\])lib\.[^/\\]+\.d\.ts$/i.test(declaration.getSourceFile().fileName));
98
- }
99
-
85
+ const role = sourceRole(sourceFile);
86
+ if (role.transport || NON_API_SOURCE_ROLES.has(role.role ?? '') || NON_API_SOURCE_ROLES.has(role.base))
87
+ return true;
88
+ if (declaration?.name && (declaration.name.text ?? '').endsWith('Module')) {
89
+ return nodeDecorators(framework.ts, declaration).some((decorator) => decoratorKind(framework.ts, framework.checker, decorator, framework.targets) === 'Module');
90
+ }
91
+ return false;
92
+ }
93
+ function builtinSymbol(_ts, symbol, name) {
94
+ if (!symbol || symbol.getName?.() !== name)
95
+ return false;
96
+ const declarations = symbol.getDeclarations?.() ?? [];
97
+ return declarations.length > 0 && declarations.every((declaration) => declaration.getSourceFile().isDeclarationFile
98
+ && /(?:^|[/\\])lib\.[^/\\]+\.d\.ts$/i.test(declaration.getSourceFile().fileName));
99
+ }
100
100
  function typeReferenceStatus(ts, checker, node, seen, depth) {
101
- const symbol = normalizedSymbol(ts, checker, node.typeName);
102
- if (!symbol) return 'unavailable';
103
- if (builtinSymbol(ts, symbol, 'Promise') || builtinSymbol(ts, symbol, 'Readonly') || builtinSymbol(ts, symbol, 'Awaited')
104
- || builtinSymbol(ts, symbol, 'Array') || builtinSymbol(ts, symbol, 'ReadonlyArray')) {
105
- return node.typeArguments?.length === 1 ? contractTypeStatus(ts, checker, node.typeArguments[0], seen, depth + 1) : 'unavailable';
106
- }
107
- if (builtinSymbol(ts, symbol, 'Record') || builtinSymbol(ts, symbol, 'Partial') || builtinSymbol(ts, symbol, 'Pick')
108
- || builtinSymbol(ts, symbol, 'Omit') || builtinSymbol(ts, symbol, 'Required')) return 'inline';
109
- const declarations = symbol.getDeclarations?.() ?? [];
110
- if (!declarations.length) return 'unavailable';
111
- return declarations.every(declaration => ts.isTypeParameterDeclaration(declaration)
112
- || ts.isInterfaceDeclaration(declaration) || ts.isTypeAliasDeclaration(declaration)
113
- || ts.isClassDeclaration(declaration) || ts.isEnumDeclaration(declaration)) ? 'named' : 'unavailable';
114
- }
115
-
101
+ const symbol = normalizedSymbol(ts, checker, node.typeName);
102
+ if (!symbol)
103
+ return 'unavailable';
104
+ if (builtinSymbol(ts, symbol, 'Promise') || builtinSymbol(ts, symbol, 'Readonly') || builtinSymbol(ts, symbol, 'Awaited')
105
+ || builtinSymbol(ts, symbol, 'Array') || builtinSymbol(ts, symbol, 'ReadonlyArray')) {
106
+ return node.typeArguments?.length === 1 ? contractTypeStatus(ts, checker, node.typeArguments[0], seen, depth + 1) : 'unavailable';
107
+ }
108
+ if (builtinSymbol(ts, symbol, 'Record') || builtinSymbol(ts, symbol, 'Partial') || builtinSymbol(ts, symbol, 'Pick')
109
+ || builtinSymbol(ts, symbol, 'Omit') || builtinSymbol(ts, symbol, 'Required'))
110
+ return 'inline';
111
+ const declarations = symbol.getDeclarations?.() ?? [];
112
+ if (!declarations.length)
113
+ return 'unavailable';
114
+ return declarations.every((declaration) => ts.isTypeParameterDeclaration(declaration)
115
+ || ts.isInterfaceDeclaration(declaration) || ts.isTypeAliasDeclaration(declaration)
116
+ || ts.isClassDeclaration(declaration) || ts.isEnumDeclaration(declaration)) ? 'named' : 'unavailable';
117
+ }
116
118
  function isInlineContractType(ts, node) {
117
- return ts.isTypeLiteralNode(node) || ts.isMappedTypeNode(node) || ts.isUnionTypeNode(node)
118
- || ts.isIntersectionTypeNode(node) || ts.isTupleTypeNode(node) || ts.isFunctionTypeNode(node);
119
+ return ts.isTypeLiteralNode(node) || ts.isMappedTypeNode(node) || ts.isUnionTypeNode(node)
120
+ || ts.isIntersectionTypeNode(node) || ts.isTupleTypeNode(node) || ts.isFunctionTypeNode(node);
119
121
  }
120
-
121
122
  function isUnavailableContractType(ts, node) {
122
- return ts.isConditionalTypeNode(node) || ts.isIndexedAccessTypeNode(node) || ts.isInferTypeNode(node)
123
- || ts.isTypeQueryNode(node) || ts.isImportTypeNode(node);
123
+ return ts.isConditionalTypeNode(node) || ts.isIndexedAccessTypeNode(node) || ts.isInferTypeNode(node)
124
+ || ts.isTypeQueryNode(node) || ts.isImportTypeNode(node);
124
125
  }
125
-
126
126
  function contractTypeStatus(ts, checker, node, seen = new Set(), depth = 0) {
127
- if (!node || depth > 12) return 'unavailable';
128
- if (ts.isParenthesizedTypeNode(node)) return contractTypeStatus(ts, checker, node.type, seen, depth + 1);
129
- if (ts.isTypeOperatorNode(node) && node.operator === ts.SyntaxKind.ReadonlyKeyword) {
130
- return contractTypeStatus(ts, checker, node.type, seen, depth + 1);
131
- }
132
- if (ts.isTypeReferenceNode(node)) return typeReferenceStatus(ts, checker, node, seen, depth);
133
- if (ts.isArrayTypeNode(node)) return contractTypeStatus(ts, checker, node.elementType, seen, depth + 1);
134
- if (isInlineContractType(ts, node)) return 'inline';
135
- if (isUnavailableContractType(ts, node)) return 'unavailable';
136
- return 'scalar';
137
- }
138
-
127
+ if (!node || depth > 12)
128
+ return 'unavailable';
129
+ if (ts.isParenthesizedTypeNode(node))
130
+ return contractTypeStatus(ts, checker, node.type, seen, depth + 1);
131
+ if (ts.isTypeOperatorNode(node) && node.operator === ts.SyntaxKind.ReadonlyKeyword) {
132
+ return contractTypeStatus(ts, checker, node.type, seen, depth + 1);
133
+ }
134
+ if (ts.isTypeReferenceNode(node))
135
+ return typeReferenceStatus(ts, checker, node, seen, depth);
136
+ if (ts.isArrayTypeNode(node))
137
+ return contractTypeStatus(ts, checker, node.elementType, seen, depth + 1);
138
+ if (isInlineContractType(ts, node))
139
+ return 'inline';
140
+ if (isUnavailableContractType(ts, node))
141
+ return 'unavailable';
142
+ return 'scalar';
143
+ }
139
144
  function wrappedTypeStatus(ts, checker, type, named, nextSeen, depth) {
140
- for (const wrapper of ['Promise', 'Readonly', 'Awaited', 'Array', 'ReadonlyArray']) if (builtinSymbol(ts, named, wrapper)) {
141
- const argumentsList = type.aliasTypeArguments ?? (checker.getTypeArguments && hasAnyFlag(type.objectFlags, ts.ObjectFlags.Reference)
142
- ? checker.getTypeArguments(type) : type.typeArguments) ?? [];
143
- return argumentsList.length === 1 ? contractTypeStatusFromType(ts, checker, argumentsList[0], nextSeen, depth + 1) : 'unavailable';
144
- }
145
- for (const anonymous of ['Record', 'Partial', 'Pick', 'Omit', 'Required']) if (builtinSymbol(ts, named, anonymous)) return 'inline';
146
- return null;
147
- }
148
-
145
+ for (const wrapper of ['Promise', 'Readonly', 'Awaited', 'Array', 'ReadonlyArray'])
146
+ if (builtinSymbol(ts, named, wrapper)) {
147
+ const argumentsList = type.aliasTypeArguments ?? (typeof checker.getTypeArguments === 'function' && hasAnyFlag(type.objectFlags, ts.ObjectFlags.Reference)
148
+ ? checker.getTypeArguments(type) : type.typeArguments) ?? [];
149
+ return argumentsList.length === 1 ? contractTypeStatusFromType(ts, checker, argumentsList[0], nextSeen, depth + 1) : 'unavailable';
150
+ }
151
+ for (const anonymous of ['Record', 'Partial', 'Pick', 'Omit', 'Required'])
152
+ if (builtinSymbol(ts, named, anonymous))
153
+ return 'inline';
154
+ return null;
155
+ }
149
156
  function objectContractTypeStatus(ts, checker, type, nextSeen, depth) {
150
- if (checker.isTupleType?.(type)) return 'inline';
151
- if (checker.isArrayType?.(type)) {
152
- const argumentsList = checker.getTypeArguments?.(type) ?? [];
153
- return argumentsList.length === 1 ? contractTypeStatusFromType(ts, checker, argumentsList[0], nextSeen, depth + 1) : 'unavailable';
154
- }
155
- const declarations = type.symbol?.getDeclarations?.() ?? [];
156
- if (type.symbol?.getName().startsWith('__') === false && declarations.some(declaration => ts.isInterfaceDeclaration(declaration)
157
- || ts.isClassDeclaration(declaration) || ts.isTypeAliasDeclaration(declaration) || ts.isEnumDeclaration(declaration))) return 'named';
158
- return 'inline';
159
- }
160
-
157
+ if (checker.isTupleType?.(type))
158
+ return 'inline';
159
+ if (checker.isArrayType?.(type)) {
160
+ const argumentsList = checker.getTypeArguments?.(type) ?? [];
161
+ return argumentsList.length === 1 ? contractTypeStatusFromType(ts, checker, argumentsList[0], nextSeen, depth + 1) : 'unavailable';
162
+ }
163
+ const declarations = type.symbol?.getDeclarations?.() ?? [];
164
+ if (type.symbol?.getName().startsWith('__') === false && declarations.some((declaration) => ts.isInterfaceDeclaration(declaration)
165
+ || ts.isClassDeclaration(declaration) || ts.isTypeAliasDeclaration(declaration) || ts.isEnumDeclaration(declaration)))
166
+ return 'named';
167
+ return 'inline';
168
+ }
161
169
  function contractTypeStatusFromType(ts, checker, type, seen = new Set(), depth = 0) {
162
- if (!type || depth > 12 || seen.has(type)) return 'unavailable';
163
- if (hasAnyFlag(type.flags, ts.TypeFlags.Any | ts.TypeFlags.Unknown)) return 'unavailable';
164
- const nextSeen = new Set(seen).add(type);
165
- const named = type.aliasSymbol ?? type.symbol ?? null;
166
- const wrapperStatus = wrappedTypeStatus(ts, checker, type, named, nextSeen, depth);
167
- if (wrapperStatus !== null) return wrapperStatus;
168
- if (type.aliasSymbol) return 'named';
169
- if ((type.symbol?.getDeclarations?.() ?? []).some(declaration => ts.isEnumDeclaration(declaration))) return 'named';
170
- if (hasAnyFlag(type.flags, ts.TypeFlags.TypeParameter)) return 'named';
171
- if (hasAnyFlag(type.flags, ts.TypeFlags.Boolean)) return 'scalar';
172
- if (hasAnyFlag(type.flags, ts.TypeFlags.Union | ts.TypeFlags.Intersection)) return 'inline';
173
- if (hasAnyFlag(type.flags, ts.TypeFlags.Object)) return objectContractTypeStatus(ts, checker, type, nextSeen, depth);
174
- if (hasAnyFlag(type.flags, ts.TypeFlags.Conditional | ts.TypeFlags.IndexedAccess | ts.TypeFlags.Substitution)) return 'unavailable';
175
- return 'scalar';
176
- }
177
-
170
+ if (!type || depth > 12 || seen.has(type))
171
+ return 'unavailable';
172
+ if (hasAnyFlag(type.flags, ts.TypeFlags.Any | ts.TypeFlags.Unknown))
173
+ return 'unavailable';
174
+ const nextSeen = new Set(seen).add(type);
175
+ const named = type.aliasSymbol ?? type.symbol ?? null;
176
+ const wrapperStatus = wrappedTypeStatus(ts, checker, type, named, nextSeen, depth);
177
+ if (wrapperStatus !== null)
178
+ return wrapperStatus;
179
+ if (type.aliasSymbol)
180
+ return 'named';
181
+ if ((type.symbol?.getDeclarations?.() ?? []).some((declaration) => ts.isEnumDeclaration(declaration)))
182
+ return 'named';
183
+ if (hasAnyFlag(type.flags, ts.TypeFlags.TypeParameter))
184
+ return 'named';
185
+ if (hasAnyFlag(type.flags, ts.TypeFlags.Boolean))
186
+ return 'scalar';
187
+ if (hasAnyFlag(type.flags, ts.TypeFlags.Union | ts.TypeFlags.Intersection))
188
+ return 'inline';
189
+ if (hasAnyFlag(type.flags, ts.TypeFlags.Object))
190
+ return objectContractTypeStatus(ts, checker, type, nextSeen, depth);
191
+ if (hasAnyFlag(type.flags, ts.TypeFlags.Conditional | ts.TypeFlags.IndexedAccess | ts.TypeFlags.Substitution))
192
+ return 'unavailable';
193
+ return 'scalar';
194
+ }
178
195
  function callableSignatures(ts, symbol, checker, location) {
179
- const type = checker.getTypeOfSymbolAtLocation(symbol, location);
180
- const signatures = checker.getSignaturesOfType(type, ts.SignatureKind.Call);
181
- const bodyless = signatures.filter(signature => signature.getDeclaration() && !signature.getDeclaration().body);
182
- return bodyless.length ? bodyless : signatures.filter(signature => signature.getDeclaration());
196
+ const type = checker.getTypeOfSymbolAtLocation(symbol, location);
197
+ const signatures = checker.getSignaturesOfType(type, ts.SignatureKind.Call);
198
+ const bodyless = signatures.filter((signature) => signature.getDeclaration() && !signature.getDeclaration().body);
199
+ return bodyless.length ? bodyless : signatures.filter((signature) => signature.getDeclaration());
183
200
  }
184
-
185
201
  function signatureParameterStatus(ts, checker, signature, location, parameter, signatureIndex) {
186
- const parameterSymbol = signature.getParameters()[signatureIndex];
187
- const actual = parameterSymbol ? checker.getTypeOfSymbolAtLocation(parameterSymbol, location) : null;
188
- if (actual && parameter.questionToken && !ts.isUnionTypeNode(parameter.type) && hasAnyFlag(actual.flags, ts.TypeFlags.Union)) {
189
- const selected = actual.types.filter(type => !hasAnyFlag(type.flags, ts.TypeFlags.Undefined));
190
- return selected.length === 1 ? contractTypeStatusFromType(ts, checker, selected[0]) : 'inline';
191
- }
192
- return actual ? contractTypeStatusFromType(ts, checker, actual) : contractTypeStatus(ts, checker, parameter.type);
193
- }
194
-
202
+ const parameterSymbol = signature.getParameters()[signatureIndex];
203
+ const actual = parameterSymbol ? checker.getTypeOfSymbolAtLocation(parameterSymbol, location) : null;
204
+ if (actual && parameter.questionToken && !ts.isUnionTypeNode(parameter.type) && hasAnyFlag(actual.flags, ts.TypeFlags.Union)) {
205
+ const selected = actual.types.filter((type) => !hasAnyFlag(type.flags, ts.TypeFlags.Undefined));
206
+ return selected.length === 1 ? contractTypeStatusFromType(ts, checker, selected[0]) : 'inline';
207
+ }
208
+ return actual ? contractTypeStatusFromType(ts, checker, actual) : contractTypeStatus(ts, checker, parameter.type);
209
+ }
195
210
  function checkSignatureInputs(state, declaration) {
196
- const { config, context, checker, signature, location, reportSource, reportNode, displayName, violations, reasons } = state;
197
- const ts = context.ts;
198
- let signatureIndex = 0;
199
- for (let index = 0; index < (declaration.parameters?.length ?? 0); index += 1) {
200
- const parameter = declaration.parameters[index];
201
- if (parameter.name && ts.isIdentifier(parameter.name) && parameter.name.text === 'this') continue;
202
- if (!parameter.type) {
203
- violations.push(violation(config, reportSource, reportNode ?? parameter, PUBLIC_CONTRACT_RULE_ID,
204
- `${displayName} must declare the type of each public input.`));
205
- signatureIndex += 1;
206
- continue;
211
+ const { config, context, checker, signature, location, reportSource, reportNode, displayName, violations, reasons } = state;
212
+ const ts = context.ts;
213
+ let signatureIndex = 0;
214
+ for (let index = 0; index < (declaration.parameters?.length ?? 0); index += 1) {
215
+ const parameter = declaration.parameters[index];
216
+ if (parameter.name && ts.isIdentifier(parameter.name) && parameter.name.text === 'this')
217
+ continue;
218
+ if (!parameter.type) {
219
+ violations.push(violation(config, reportSource, reportNode ?? parameter, PUBLIC_CONTRACT_RULE_ID, `${displayName} must declare the type of each public input.`));
220
+ signatureIndex += 1;
221
+ continue;
222
+ }
223
+ const status = signatureParameterStatus(ts, checker, signature, location, parameter, signatureIndex);
224
+ signatureIndex += 1;
225
+ if (status === 'inline')
226
+ violations.push(violation(config, reportSource, reportNode ?? parameter.type, PUBLIC_CONTRACT_RULE_ID, `${displayName} uses an inline object/union input; expose a named contract or a positional primitive.`));
227
+ else if (status === 'unavailable')
228
+ reasons.push(`${relativePath(config.root, reportSource.fileName)} cannot prove the public input type of ${displayName}`);
207
229
  }
208
- const status = signatureParameterStatus(ts, checker, signature, location, parameter, signatureIndex);
209
- signatureIndex += 1;
210
- if (status === 'inline') violations.push(violation(config, reportSource, reportNode ?? parameter.type, PUBLIC_CONTRACT_RULE_ID,
211
- `${displayName} uses an inline object/union input; expose a named contract or a positional primitive.`));
212
- else if (status === 'unavailable') reasons.push(`${relativePath(config.root, reportSource.fileName)} cannot prove the public input type of ${displayName}`);
213
- }
214
- }
215
-
230
+ }
216
231
  function checkSignatureOutput(state, declaration) {
217
- const { config, context, checker, signature, reportSource, reportNode, displayName, violations, reasons } = state;
218
- const ts = context.ts;
219
- if (!declaration.type) {
220
- violations.push(violation(config, reportSource, reportNode ?? declaration, PUBLIC_CONTRACT_RULE_ID,
221
- `${displayName} must declare an explicit public output type.`));
222
- return;
223
- }
224
- const actual = checker.getReturnTypeOfSignature(signature);
225
- const status = actual ? contractTypeStatusFromType(ts, checker, actual) : contractTypeStatus(ts, checker, declaration.type);
226
- if (status === 'inline') violations.push(violation(config, reportSource, reportNode ?? declaration.type, PUBLIC_CONTRACT_RULE_ID,
227
- `${displayName} uses an inline object/union output; expose a named result contract or a primitive.`));
228
- else if (status === 'unavailable') reasons.push(`${relativePath(config.root, reportSource.fileName)} cannot prove the public output type of ${displayName}`);
229
- }
230
-
232
+ const { config, context, checker, signature, reportSource, reportNode, displayName, violations, reasons } = state;
233
+ const ts = context.ts;
234
+ if (!declaration.type) {
235
+ violations.push(violation(config, reportSource, reportNode ?? declaration, PUBLIC_CONTRACT_RULE_ID, `${displayName} must declare an explicit public output type.`));
236
+ return;
237
+ }
238
+ const actual = checker.getReturnTypeOfSignature(signature);
239
+ const status = actual ? contractTypeStatusFromType(ts, checker, actual) : contractTypeStatus(ts, checker, declaration.type);
240
+ if (status === 'inline')
241
+ violations.push(violation(config, reportSource, reportNode ?? declaration.type, PUBLIC_CONTRACT_RULE_ID, `${displayName} uses an inline object/union output; expose a named result contract or a primitive.`));
242
+ else if (status === 'unavailable')
243
+ reasons.push(`${relativePath(config.root, reportSource.fileName)} cannot prove the public output type of ${displayName}`);
244
+ }
231
245
  function checkSignature(state) {
232
- const declaration = state.signature.getDeclaration();
233
- checkSignatureInputs(state, declaration);
234
- checkSignatureOutput(state, declaration);
246
+ const declaration = state.signature.getDeclaration();
247
+ checkSignatureInputs(state, declaration);
248
+ checkSignatureOutput(state, declaration);
235
249
  }
236
-
237
250
  function symbolName(symbol) {
238
- const name = symbol.getName?.() ?? '(anonymous)';
239
- return name === '__call' ? '(callable)' : name;
251
+ const name = symbol.getName?.() ?? '(anonymous)';
252
+ return name === '__call' ? '(callable)' : name;
240
253
  }
241
-
242
254
  function isRepositoryDeclaration(declaration, localFiles) {
243
- return localFiles.has(canonical(declaration.getSourceFile().fileName));
255
+ return localFiles.has(canonical(declaration.getSourceFile().fileName));
244
256
  }
245
-
246
257
  const isPublicCallableDeclaration = (ts, declaration) => ts.isMethodDeclaration(declaration) || ts.isMethodSignature(declaration)
247
- || ts.isPropertyDeclaration(declaration) || ts.isPropertySignature(declaration) || ts.isGetAccessorDeclaration(declaration);
248
-
258
+ || ts.isPropertyDeclaration(declaration) || ts.isPropertySignature(declaration) || ts.isGetAccessorDeclaration(declaration);
249
259
  function isCallableMember(ts, checker, member, location, localFiles) {
250
- if (member.getName() === 'prototype') return false;
251
- const selected = member.getDeclarations?.() ?? [];
252
- return selected.some(declaration => isPublicCallableDeclaration(ts, declaration)
253
- && isPublicMember(ts, declaration) && isRepositoryDeclaration(declaration, localFiles))
254
- && checker.getSignaturesOfType(checker.getTypeOfSymbolAtLocation(member, location), ts.SignatureKind.Call).length;
260
+ if (member.getName() === 'prototype')
261
+ return false;
262
+ const selected = member.getDeclarations?.() ?? [];
263
+ return Boolean(selected.some((declaration) => isPublicCallableDeclaration(ts, declaration)
264
+ && isPublicMember(ts, declaration) && isRepositoryDeclaration(declaration, localFiles))
265
+ && checker.getSignaturesOfType(checker.getTypeOfSymbolAtLocation(member, location), ts.SignatureKind.Call).length);
255
266
  }
256
-
257
267
  function callableMembers(ts, checker, symbol, location, localFiles) {
258
- const declarations = symbol.getDeclarations?.() ?? [];
259
- const classExpressions = declarations.flatMap(declaration => ts.isVariableDeclaration(declaration)
260
- && declaration.initializer && ts.isClassExpression(unwrapExpression(ts, declaration.initializer))
261
- ? [unwrapExpression(ts, declaration.initializer)] : []);
262
- const valueType = checker.getTypeOfSymbolAtLocation(symbol, location);
263
- const declaredClassLike = declarations.some(declaration => ts.isClassDeclaration(declaration) || ts.isInterfaceDeclaration(declaration));
264
- const primary = declaredClassLike ? checker.getDeclaredTypeOfSymbol(symbol) : valueType;
265
- const types = [primary];
266
- if (declaredClassLike || classExpressions.length) types.push(valueType);
267
- for (const signature of checker.getSignaturesOfType(valueType, ts.SignatureKind.Construct)) types.push(checker.getReturnTypeOfSignature(signature));
268
- const direct = checker.getSignaturesOfType(primary, ts.SignatureKind.Call).length ? [symbol] : [];
269
- const members = types.flatMap(type => checker.getPropertiesOfType(type)).filter(member => isCallableMember(ts, checker, member, location, localFiles));
270
- return [...new Set([...direct, ...members])];
271
- }
272
-
268
+ const declarations = symbol.getDeclarations?.() ?? [];
269
+ const classExpressions = declarations.flatMap((declaration) => ts.isVariableDeclaration(declaration)
270
+ && declaration.initializer && ts.isClassExpression(unwrapExpression(ts, declaration.initializer))
271
+ ? [unwrapExpression(ts, declaration.initializer)] : []);
272
+ const valueType = checker.getTypeOfSymbolAtLocation(symbol, location);
273
+ const declaredClassLike = declarations.some(declaration => ts.isClassDeclaration(declaration) || ts.isInterfaceDeclaration(declaration));
274
+ const primary = declaredClassLike ? checker.getDeclaredTypeOfSymbol(symbol) : valueType;
275
+ const types = [primary];
276
+ if (declaredClassLike || classExpressions.length)
277
+ types.push(valueType);
278
+ for (const signature of checker.getSignaturesOfType(valueType, ts.SignatureKind.Construct))
279
+ types.push(checker.getReturnTypeOfSignature(signature));
280
+ const direct = checker.getSignaturesOfType(primary, ts.SignatureKind.Call).length ? [symbol] : [];
281
+ const members = types.flatMap((type) => checker.getPropertiesOfType(type)).filter((member) => isCallableMember(ts, checker, member, location, localFiles));
282
+ return [...new Set([...direct, ...members])];
283
+ }
273
284
  function exportedSymbols(ts, checker, sourceFile) {
274
- const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
275
- return moduleSymbol ? checker.getExportsOfModule(moduleSymbol).map(symbol => normalizedSymbolValue(ts, checker, symbol)).filter(Boolean) : [];
285
+ const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
286
+ return moduleSymbol ? checker.getExportsOfModule(moduleSymbol).map((symbol) => normalizedSymbolValue(ts, checker, symbol)).filter((symbol) => Boolean(symbol)) : [];
276
287
  }
277
-
278
288
  function checkCallableSymbol({ config, context, checker, symbol, location, reportSource, reportNode, violations, reasons, seen, localFiles }) {
279
- if (seen.has(symbol)) return 0;
280
- seen.add(symbol);
281
- let checked = 0;
282
- for (const callable of callableMembers(context.ts, checker, symbol, location, localFiles)) {
283
- if (callable !== symbol && seen.has(callable)) continue;
284
- seen.add(callable);
285
- const signatures = callableSignatures(context.ts, callable, checker, location);
286
- if (!signatures.length) {
287
- reasons.push(`${relativePath(config.root, reportSource.fileName)} cannot resolve the callable signature of ${symbolName(callable)}`);
288
- continue;
289
+ if (seen.has(symbol))
290
+ return 0;
291
+ seen.add(symbol);
292
+ let checked = 0;
293
+ for (const callable of callableMembers(context.ts, checker, symbol, location, localFiles)) {
294
+ if (callable !== symbol && seen.has(callable))
295
+ continue;
296
+ seen.add(callable);
297
+ const signatures = callableSignatures(context.ts, callable, checker, location);
298
+ if (!signatures.length) {
299
+ reasons.push(`${relativePath(config.root, reportSource.fileName)} cannot resolve the callable signature of ${symbolName(callable)}`);
300
+ continue;
301
+ }
302
+ for (const signature of signatures) {
303
+ checked += 1;
304
+ checkSignature({ config, context, checker, signature, location, reportSource, reportNode,
305
+ displayName: callable === symbol ? symbolName(symbol) : `${symbolName(symbol)}.${symbolName(callable)}`,
306
+ violations, reasons });
307
+ }
289
308
  }
290
- for (const signature of signatures) {
291
- checked += 1;
292
- checkSignature({ config, context, checker, signature, location, reportSource, reportNode,
293
- displayName: callable === symbol ? symbolName(symbol) : `${symbolName(symbol)}.${symbolName(callable)}`,
294
- violations, reasons });
295
- }
296
- }
297
- return checked;
309
+ return checked;
298
310
  }
299
-
300
311
  function frameworkFor(state, checker) {
301
- if (!state.frameworkByChecker.has(checker)) {
302
- const selected = frameworkTargets(state.config, state.context, checker, state.localFiles);
303
- state.frameworkByChecker.set(checker, { ...selected, ts: state.ts, checker, targets: selected.bySymbol });
304
- state.readonlyReasons.push(...selected.reasons);
305
- }
306
- return state.frameworkByChecker.get(checker);
307
- }
308
-
312
+ if (!state.frameworkByChecker.has(checker)) {
313
+ const selected = frameworkTargets(state.config, state.context, checker, state.localFiles);
314
+ state.frameworkByChecker.set(checker, { ...selected, ts: state.ts, checker, targets: selected.bySymbol });
315
+ state.readonlyReasons.push(...selected.reasons);
316
+ }
317
+ return state.frameworkByChecker.get(checker);
318
+ }
309
319
  function checkOwnerCoverage(state) {
310
- const { config, context, publicReasons } = state;
311
- if (!config.owners?.length) publicReasons.push('no slot owner with an entry file exists, so capability API discovery has no owners to list');
312
- const ownerRoots = (config.owners ?? []).map(owner => path.resolve(config.root, ...owner.root.split('/')));
313
- const publicSourceRoots = [...config.backend.features, ...config.backend.modules].map(root => path.resolve(config.root, ...root.split('/')));
314
- for (const sourceFile of context.files) if (publicSourceRoots.some(root => isInside(root, sourceFile.fileName))
315
- && !ownerRoots.some(root => isInside(root, sourceFile.fileName))) {
316
- publicReasons.push(`${relativePath(config.root, sourceFile.fileName)} is outside every declared owner root`);
317
- }
318
- }
319
-
320
+ const { config, context, publicReasons } = state;
321
+ if (!config.owners?.length)
322
+ publicReasons.push('no slot owner with an entry file exists, so capability API discovery has no owners to list');
323
+ const ownerRoots = (config.owners ?? []).map((owner) => path.resolve(config.root, ...owner.root.split('/')));
324
+ const publicSourceRoots = [...config.backend.features, ...config.backend.modules].map((root) => path.resolve(config.root, ...root.split('/')));
325
+ for (const sourceFile of context.files)
326
+ if (publicSourceRoots.some((root) => isInside(root, sourceFile.fileName))
327
+ && !ownerRoots.some((root) => isInside(root, sourceFile.fileName))) {
328
+ publicReasons.push(`${relativePath(config.root, sourceFile.fileName)} is outside every declared owner root`);
329
+ }
330
+ }
320
331
  function checkExportedSymbol(state, checker, framework, symbol) {
321
- const { context, localFiles, publicReasons, violations, publicSeen } = state;
322
- const declarations = (symbol.getDeclarations?.() ?? []).filter(declaration => localFiles.has(canonical(declaration.getSourceFile().fileName))) ?? [];
323
- if (!declarations.length) return;
324
- const representative = declarations[0];
325
- if (isFrameworkHelper(representative.getSourceFile(), representative, framework)) return;
326
- state.callableSignatures += checkCallableSymbol({ config: state.config, context, checker, symbol, location: representative,
327
- reportSource: representative.getSourceFile(), reportNode: representative.name ?? representative,
328
- violations, reasons: publicReasons, seen: publicSeen, localFiles });
329
- }
330
-
332
+ const { context, localFiles, publicReasons, violations, publicSeen } = state;
333
+ const declarations = (symbol.getDeclarations?.() ?? []).filter((declaration) => localFiles.has(canonical(declaration.getSourceFile().fileName))) ?? [];
334
+ if (!declarations.length)
335
+ return;
336
+ const representative = declarations[0];
337
+ if (isFrameworkHelper(representative.getSourceFile(), representative, framework))
338
+ return;
339
+ state.callableSignatures += checkCallableSymbol({ config: state.config, context, checker, symbol, location: representative,
340
+ reportSource: representative.getSourceFile(), reportNode: representative.name ?? representative,
341
+ violations, reasons: publicReasons, seen: publicSeen, localFiles });
342
+ }
331
343
  function checkOwnerEntry(state, owner) {
332
- const { config, context, ts, sourceFiles, publicReasons } = state;
333
- const entry = sourceFiles.get(canonical(path.resolve(config.root, ...owner.entry.split('/'))));
334
- if (!entry) {
335
- publicReasons.push(`${owner.entry} is outside the checked production program`);
336
- return;
337
- }
338
- const checker = context.checkerFor(entry.fileName);
339
- const framework = frameworkFor(state, checker);
340
- if (entry.statements.some(statement => ts.isExportAssignment(statement) && statement.isExportEquals)) {
341
- publicReasons.push(`${owner.entry} uses export =, so named capability API discovery is unavailable`);
342
- }
343
- for (const symbol of exportedSymbols(ts, checker, entry)) checkExportedSymbol(state, checker, framework, symbol);
344
- }
345
-
344
+ const { config, context, ts, sourceFiles, publicReasons } = state;
345
+ const entry = sourceFiles.get(canonical(path.resolve(config.root, ...owner.entry.split('/'))));
346
+ if (!entry) {
347
+ publicReasons.push(`${owner.entry} is outside the checked production program`);
348
+ return;
349
+ }
350
+ const checker = checkerFor(context, entry.fileName);
351
+ const framework = frameworkFor(state, checker);
352
+ if (entry.statements.some((statement) => ts.isExportAssignment(statement) && statement.isExportEquals)) {
353
+ publicReasons.push(`${owner.entry} uses export =, so named capability API discovery is unavailable`);
354
+ }
355
+ for (const symbol of exportedSymbols(ts, checker, entry))
356
+ checkExportedSymbol(state, checker, framework, symbol);
357
+ }
346
358
  function checkPublicOwners(state) {
347
- for (const owner of state.config.owners ?? []) checkOwnerEntry(state, owner);
359
+ for (const owner of state.config.owners ?? [])
360
+ checkOwnerEntry(state, owner);
348
361
  }
349
-
350
362
  function classesInSource(ts, sourceFile) {
351
- const classes = [];
352
- const collect = node => {
353
- if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) classes.push(node);
354
- ts.forEachChild(node, collect);
355
- };
356
- collect(sourceFile);
357
- return classes;
358
- }
359
-
363
+ const classes = [];
364
+ const collect = (node) => {
365
+ if (ts.isClassDeclaration(node) || ts.isClassExpression(node))
366
+ classes.push(node);
367
+ ts.forEachChild(node, collect);
368
+ };
369
+ collect(sourceFile);
370
+ return classes;
371
+ }
360
372
  function checkConstructedClassDecorators(state, sourceFile, checker, decorators, kinds, targets) {
361
- for (const [index, decorator] of decorators.entries()) if (!kinds[index]) {
362
- const constructed = constructedDecoratorKind(state.ts, checker, decorator, targets);
363
- if (constructed && (NEST_CREATED.has(constructed) || MESSAGE_HANDLERS.has(constructed) || constructed.includes('framework'))) {
364
- state.readonlyReasons.push(`${relativePath(state.config.root, sourceFile.fileName)} has a constructed ${constructed} decorator identity`);
365
- }
366
- }
373
+ for (const [index, decorator] of decorators.entries())
374
+ if (!kinds[index]) {
375
+ const constructed = constructedDecoratorKind(state.ts, checker, decorator, targets);
376
+ if (constructed && (NEST_CREATED.has(constructed) || MESSAGE_HANDLERS.has(constructed) || constructed.includes('framework'))) {
377
+ state.readonlyReasons.push(`${relativePath(state.config.root, sourceFile.fileName)} has a constructed ${constructed} decorator identity`);
378
+ }
379
+ }
367
380
  }
368
-
369
381
  function checkConstructedMemberDecorator(state, sourceFile, checker, decorator, targets) {
370
- const { ts, config, readonlyReasons } = state;
371
- if (decoratorKind(ts, checker, decorator, targets)) return;
372
- const constructed = constructedDecoratorKind(ts, checker, decorator, targets);
373
- if (constructed === 'Inject' || constructed === 'unproven framework') {
374
- readonlyReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a constructed ${constructed} injection decorator identity`);
375
- }
376
- }
377
-
382
+ const { ts, config, readonlyReasons } = state;
383
+ if (decoratorKind(ts, checker, decorator, targets))
384
+ return;
385
+ const constructed = constructedDecoratorKind(ts, checker, decorator, targets);
386
+ if (constructed === 'Inject' || constructed === 'unproven framework') {
387
+ readonlyReasons.push(`${relativePath(config.root, sourceFile.fileName)} has a constructed ${constructed} injection decorator identity`);
388
+ }
389
+ }
378
390
  function checkConstructedMemberDecorators(state, sourceFile, declaration, checker, targets) {
379
- const { ts } = state;
380
- for (const member of declaration.members) for (const decorated of [member, ...(ts.isConstructorDeclaration(member) ? member.parameters : [])]) {
381
- for (const decorator of nodeDecorators(ts, decorated)) checkConstructedMemberDecorator(state, sourceFile, checker, decorator, targets);
382
- }
391
+ const { ts } = state;
392
+ for (const member of declaration.members)
393
+ for (const decorated of [member, ...(ts.isConstructorDeclaration(member) ? member.parameters : [])]) {
394
+ for (const decorator of nodeDecorators(ts, decorated))
395
+ checkConstructedMemberDecorator(state, sourceFile, checker, decorator, targets);
396
+ }
383
397
  }
384
-
385
398
  function hasInjectedMember(ts, checker, declaration, targets) {
386
- return declaration.members.some(member => nodeDecorators(ts, member).some(decorator => decoratorKind(ts, checker, decorator, targets) === 'Inject')
387
- || (ts.isConstructorDeclaration(member) && member.parameters.some(parameter => nodeDecorators(ts, parameter)
388
- .some(decorator => decoratorKind(ts, checker, decorator, targets) === 'Inject'))));
389
- }
390
-
391
- function checkMessageHandlers(state, sourceFile, checker, decorators, kinds) {
392
- for (const [index, decorator] of decorators.entries()) {
393
- const kind = kinds[index];
394
- if (!MESSAGE_HANDLERS.has(kind)) continue;
395
- const message = messageClass(state.config, state.context, checker, decorator, state.localFiles, state.readonlyReasons);
396
- if (!message) continue;
397
- const key = `${message.getSourceFile().fileName}:${message.pos}`;
398
- if (state.messageSeen.has(key)) continue;
399
- state.messageSeen.add(key);
400
- state.messages += 1;
401
- checkMessageReadonly(state.config, state.context, state.context.checkerFor(message.getSourceFile().fileName), message,
402
- state.localFiles, state.violations, state.readonlyReasons);
403
- }
404
- }
405
-
399
+ return declaration.members.some((member) => nodeDecorators(ts, member).some((decorator) => decoratorKind(ts, checker, decorator, targets) === 'Inject')
400
+ || (ts.isConstructorDeclaration(member) && member.parameters.some((parameter) => nodeDecorators(ts, parameter)
401
+ .some((decorator) => decoratorKind(ts, checker, decorator, targets) === 'Inject'))));
402
+ }
403
+ function checkMessageHandlers(state, checker, decorators, kinds) {
404
+ for (const [index, decorator] of decorators.entries()) {
405
+ const kind = kinds[index];
406
+ if (!kind || !MESSAGE_HANDLERS.has(kind))
407
+ continue;
408
+ const message = messageClass(state.config, state.context, checker, decorator, state.localFiles, state.readonlyReasons);
409
+ if (!message)
410
+ continue;
411
+ const key = `${message.getSourceFile().fileName}:${message.pos}`;
412
+ if (state.messageSeen.has(key))
413
+ continue;
414
+ state.messageSeen.add(key);
415
+ state.messages += 1;
416
+ checkMessageReadonly(state.config, state.context, checkerFor(state.context, message.getSourceFile().fileName), message, state.localFiles, state.violations, state.readonlyReasons);
417
+ }
418
+ }
406
419
  function checkUseCase(state, role, sourceFile, checker, declaration) {
407
- const { ts, config, context, publicReasons, publicSeen, localFiles, violations } = state;
408
- if (!(role.role === 'use-case' && !role.transport && ts.isClassDeclaration(declaration) && declaration.name)) return;
409
- const exported = exportedSymbols(ts, checker, sourceFile).some(symbol => (symbol.getDeclarations?.() ?? []).includes(declaration));
410
- if (!exported) return;
411
- const classSymbol = normalizedSymbol(ts, checker, declaration.name);
412
- const instanceType = classSymbol ? checker.getDeclaredTypeOfSymbol(classSymbol) : null;
413
- const execute = instanceType ? checker.getPropertyOfType(instanceType, 'execute') : null;
414
- if (!execute) publicReasons.push(`${relativePath(config.root, sourceFile.fileName)} exports a use-case class without a statically resolved execute contract`);
415
- else state.callableSignatures += checkCallableSymbol({ config, context, checker, symbol: execute, location: declaration,
416
- reportSource: sourceFile, reportNode: declaration.name, violations, reasons: publicReasons, seen: publicSeen, localFiles });
417
- }
418
-
420
+ const { ts, config, context, publicReasons, publicSeen, localFiles, violations } = state;
421
+ if (!(role.role === 'use-case' && !role.transport && ts.isClassDeclaration(declaration) && declaration.name))
422
+ return;
423
+ const exported = exportedSymbols(ts, checker, sourceFile).some((symbol) => (symbol.getDeclarations?.() ?? []).includes(declaration));
424
+ if (!exported)
425
+ return;
426
+ const classSymbol = normalizedSymbol(ts, checker, declaration.name);
427
+ const instanceType = classSymbol ? checker.getDeclaredTypeOfSymbol(classSymbol) : null;
428
+ const execute = instanceType ? checker.getPropertyOfType(instanceType, 'execute') : null;
429
+ if (!execute)
430
+ publicReasons.push(`${relativePath(config.root, sourceFile.fileName)} exports a use-case class without a statically resolved execute contract`);
431
+ else
432
+ state.callableSignatures += checkCallableSymbol({ config, context, checker, symbol: execute, location: declaration,
433
+ reportSource: sourceFile, reportNode: declaration.name, violations, reasons: publicReasons, seen: publicSeen, localFiles });
434
+ }
419
435
  function checkClassContracts(state, sourceFile, checker, role, declaration, framework) {
420
- const { ts, config, context, violations, readonlyReasons, localFiles } = state;
421
- const decorators = nodeDecorators(ts, declaration);
422
- const kinds = decorators.map(decorator => decoratorKind(ts, checker, decorator, framework.targets));
423
- const directKinds = kinds.filter(Boolean);
424
- checkConstructedClassDecorators(state, sourceFile, checker, decorators, kinds, framework.targets);
425
- const classKind = directKinds.find(kind => NEST_CREATED.has(kind)) ?? null;
426
- const targets = framework.targets;
427
- checkConstructedMemberDecorators(state, sourceFile, declaration, checker, targets);
428
- if (classKind || hasInjectedMember(ts, checker, declaration, targets)) {
429
- state.injectedClasses += 1;
430
- checkInjectedClass({ config, context, checker, declaration, classKind, targets, decoratorKind,
431
- localFiles, violations, reasons: readonlyReasons });
432
- }
433
- checkMessageHandlers(state, sourceFile, checker, decorators, kinds);
434
- checkUseCase(state, role, sourceFile, checker, declaration);
435
- }
436
-
436
+ const { ts, config, context, violations, readonlyReasons, localFiles } = state;
437
+ const decorators = nodeDecorators(ts, declaration);
438
+ const kinds = decorators.map((decorator) => decoratorKind(ts, checker, decorator, framework.targets));
439
+ const directKinds = kinds.filter((kind) => Boolean(kind));
440
+ checkConstructedClassDecorators(state, sourceFile, checker, decorators, kinds, framework.targets);
441
+ const classKind = directKinds.find((kind) => NEST_CREATED.has(kind)) ?? null;
442
+ const targets = framework.targets;
443
+ checkConstructedMemberDecorators(state, sourceFile, declaration, checker, targets);
444
+ if (classKind || hasInjectedMember(ts, checker, declaration, targets)) {
445
+ state.injectedClasses += 1;
446
+ checkInjectedClass({ config, context, checker, declaration, classKind, targets, decoratorKind,
447
+ localFiles, violations, reasons: readonlyReasons });
448
+ }
449
+ checkMessageHandlers(state, checker, decorators, kinds);
450
+ checkUseCase(state, role, sourceFile, checker, declaration);
451
+ }
437
452
  function checkSourceFile(state, sourceFile) {
438
- const checker = state.context.checkerFor(sourceFile.fileName);
439
- const framework = frameworkFor(state, checker);
440
- const role = sourceRole(sourceFile);
441
- for (const declaration of classesInSource(state.ts, sourceFile)) checkClassContracts(state, sourceFile, checker, role, declaration, framework);
453
+ const checker = checkerFor(state.context, sourceFile.fileName);
454
+ const framework = frameworkFor(state, checker);
455
+ const role = sourceRole(sourceFile);
456
+ for (const declaration of classesInSource(state.ts, sourceFile))
457
+ checkClassContracts(state, sourceFile, checker, role, declaration, framework);
442
458
  }
443
-
444
459
  function contractCoverage(state) {
445
- const publicDetails = [...new Set(state.publicReasons)].sort(byCodeUnit);
446
- const readonlyDetails = [...new Set(state.readonlyReasons)].sort(byCodeUnit);
447
- return {
448
- violations: state.violations,
449
- coverage: {
450
- publicContracts: publicDetails.length ? { status: 'unavailable', callableSignatures: state.callableSignatures, details: publicDetails }
451
- : { status: 'checked', callableSignatures: state.callableSignatures },
452
- readonlyBoundaries: readonlyDetails.length ? { status: 'unavailable', injectedClasses: state.injectedClasses, messages: state.messages, details: readonlyDetails }
453
- : { status: 'checked', injectedClasses: state.injectedClasses, messages: state.messages },
454
- },
455
- };
456
- }
457
-
460
+ const publicDetails = [...new Set(state.publicReasons)].sort(byCodeUnit);
461
+ const readonlyDetails = [...new Set(state.readonlyReasons)].sort(byCodeUnit);
462
+ return {
463
+ violations: state.violations,
464
+ coverage: {
465
+ publicContracts: publicDetails.length ? { status: 'unavailable', callableSignatures: state.callableSignatures, details: publicDetails }
466
+ : { status: 'checked', callableSignatures: state.callableSignatures },
467
+ readonlyBoundaries: readonlyDetails.length ? { status: 'unavailable', injectedClasses: state.injectedClasses, messages: state.messages, details: readonlyDetails }
468
+ : { status: 'checked', injectedClasses: state.injectedClasses, messages: state.messages },
469
+ },
470
+ };
471
+ }
458
472
  /** Enforce mechanically selected public contract and readonly boundaries without treating DTOs or arbitrary interfaces as APIs. */
459
473
  export function checkBackendContracts(config, context) {
460
- const state = {
461
- config, context, ts: context.ts,
462
- localFiles: new Set(context.files.map(file => canonical(file.fileName))),
463
- sourceFiles: new Map(context.files.map(file => [canonical(file.fileName), file])),
464
- frameworkByChecker: new Map(), violations: [], publicReasons: [], readonlyReasons: [],
465
- publicSeen: new Set(), messageSeen: new Set(), callableSignatures: 0, injectedClasses: 0, messages: 0,
466
- };
467
- checkOwnerCoverage(state);
468
- checkPublicOwners(state);
469
- for (const sourceFile of context.files) checkSourceFile(state, sourceFile);
470
- return contractCoverage(state);
474
+ const state = {
475
+ config, context, ts: context.ts,
476
+ localFiles: new Set(context.files.map((file) => canonical(file.fileName))),
477
+ sourceFiles: new Map(context.files.map((file) => [canonical(file.fileName), file])),
478
+ frameworkByChecker: new Map(), violations: [], publicReasons: [], readonlyReasons: [],
479
+ publicSeen: new Set(), messageSeen: new Set(), callableSignatures: 0, injectedClasses: 0, messages: 0,
480
+ };
481
+ checkOwnerCoverage(state);
482
+ checkPublicOwners(state);
483
+ for (const sourceFile of context.files)
484
+ checkSourceFile(state, sourceFile);
485
+ return contractCoverage(state);
471
486
  }