@gloocan/cat-inspector 0.1.1

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 (201) hide show
  1. package/dist/artifact-helpers.d.ts +4 -0
  2. package/dist/artifact-helpers.d.ts.map +1 -0
  3. package/dist/artifact-helpers.js +21 -0
  4. package/dist/artifact-helpers.js.map +1 -0
  5. package/dist/ast/get-all-ts-files.d.ts +5 -0
  6. package/dist/ast/get-all-ts-files.d.ts.map +1 -0
  7. package/dist/ast/get-all-ts-files.js +36 -0
  8. package/dist/ast/get-all-ts-files.js.map +1 -0
  9. package/dist/ast/merge-ast.d.ts +3 -0
  10. package/dist/ast/merge-ast.d.ts.map +1 -0
  11. package/dist/ast/merge-ast.js +40 -0
  12. package/dist/ast/merge-ast.js.map +1 -0
  13. package/dist/ast/run-ast-scanner.d.ts +15 -0
  14. package/dist/ast/run-ast-scanner.d.ts.map +1 -0
  15. package/dist/ast/run-ast-scanner.js +44 -0
  16. package/dist/ast/run-ast-scanner.js.map +1 -0
  17. package/dist/ast/scan-for-labels.d.ts +20 -0
  18. package/dist/ast/scan-for-labels.d.ts.map +1 -0
  19. package/dist/ast/scan-for-labels.js +88 -0
  20. package/dist/ast/scan-for-labels.js.map +1 -0
  21. package/dist/ast/scan-for-returns.d.ts +13 -0
  22. package/dist/ast/scan-for-returns.d.ts.map +1 -0
  23. package/dist/ast/scan-for-returns.js +48 -0
  24. package/dist/ast/scan-for-returns.js.map +1 -0
  25. package/dist/ast/type-expand.d.ts +16 -0
  26. package/dist/ast/type-expand.d.ts.map +1 -0
  27. package/dist/ast/type-expand.js +118 -0
  28. package/dist/ast/type-expand.js.map +1 -0
  29. package/dist/ast/visit-node.d.ts +31 -0
  30. package/dist/ast/visit-node.d.ts.map +1 -0
  31. package/dist/ast/visit-node.js +298 -0
  32. package/dist/ast/visit-node.js.map +1 -0
  33. package/dist/bootstrap.d.ts +105 -0
  34. package/dist/bootstrap.d.ts.map +1 -0
  35. package/dist/bootstrap.js +121 -0
  36. package/dist/bootstrap.js.map +1 -0
  37. package/dist/catalog-bootstrap-cache.d.ts +23 -0
  38. package/dist/catalog-bootstrap-cache.d.ts.map +1 -0
  39. package/dist/catalog-bootstrap-cache.js +54 -0
  40. package/dist/catalog-bootstrap-cache.js.map +1 -0
  41. package/dist/catalog-fingerprint.d.ts +20 -0
  42. package/dist/catalog-fingerprint.d.ts.map +1 -0
  43. package/dist/catalog-fingerprint.js +57 -0
  44. package/dist/catalog-fingerprint.js.map +1 -0
  45. package/dist/coverage/compute-coverage.d.ts +41 -0
  46. package/dist/coverage/compute-coverage.d.ts.map +1 -0
  47. package/dist/coverage/compute-coverage.js +229 -0
  48. package/dist/coverage/compute-coverage.js.map +1 -0
  49. package/dist/coverage/scan-all-service-candidates.d.ts +15 -0
  50. package/dist/coverage/scan-all-service-candidates.d.ts.map +1 -0
  51. package/dist/coverage/scan-all-service-candidates.js +73 -0
  52. package/dist/coverage/scan-all-service-candidates.js.map +1 -0
  53. package/dist/coverage/scan-express-candidates.d.ts +17 -0
  54. package/dist/coverage/scan-express-candidates.d.ts.map +1 -0
  55. package/dist/coverage/scan-express-candidates.js +300 -0
  56. package/dist/coverage/scan-express-candidates.js.map +1 -0
  57. package/dist/coverage/scan-reachable-services.d.ts +13 -0
  58. package/dist/coverage/scan-reachable-services.d.ts.map +1 -0
  59. package/dist/coverage/scan-reachable-services.js +469 -0
  60. package/dist/coverage/scan-reachable-services.js.map +1 -0
  61. package/dist/coverage/types.d.ts +32 -0
  62. package/dist/coverage/types.d.ts.map +1 -0
  63. package/dist/coverage/types.js +2 -0
  64. package/dist/coverage/types.js.map +1 -0
  65. package/dist/decorators/cat-class.d.ts +11 -0
  66. package/dist/decorators/cat-class.d.ts.map +1 -0
  67. package/dist/decorators/cat-class.js +20 -0
  68. package/dist/decorators/cat-class.js.map +1 -0
  69. package/dist/decorators/cat.d.ts +3 -0
  70. package/dist/decorators/cat.d.ts.map +1 -0
  71. package/dist/decorators/cat.js +102 -0
  72. package/dist/decorators/cat.js.map +1 -0
  73. package/dist/express-inspector-correlation.d.ts +23 -0
  74. package/dist/express-inspector-correlation.d.ts.map +1 -0
  75. package/dist/express-inspector-correlation.js +50 -0
  76. package/dist/express-inspector-correlation.js.map +1 -0
  77. package/dist/express-playground-mocks.d.ts +28 -0
  78. package/dist/express-playground-mocks.d.ts.map +1 -0
  79. package/dist/express-playground-mocks.js +55 -0
  80. package/dist/express-playground-mocks.js.map +1 -0
  81. package/dist/express-qa-host-minio-upload.d.ts +16 -0
  82. package/dist/express-qa-host-minio-upload.d.ts.map +1 -0
  83. package/dist/express-qa-host-minio-upload.js +56 -0
  84. package/dist/express-qa-host-minio-upload.js.map +1 -0
  85. package/dist/express.d.ts +21 -0
  86. package/dist/express.d.ts.map +1 -0
  87. package/dist/express.js +167 -0
  88. package/dist/express.js.map +1 -0
  89. package/dist/functional.d.ts +15 -0
  90. package/dist/functional.d.ts.map +1 -0
  91. package/dist/functional.js +165 -0
  92. package/dist/functional.js.map +1 -0
  93. package/dist/graph/relationships.d.ts +9 -0
  94. package/dist/graph/relationships.d.ts.map +1 -0
  95. package/dist/graph/relationships.js +92 -0
  96. package/dist/graph/relationships.js.map +1 -0
  97. package/dist/http-bridge-registry.d.ts +26 -0
  98. package/dist/http-bridge-registry.d.ts.map +1 -0
  99. package/dist/http-bridge-registry.js +39 -0
  100. package/dist/http-bridge-registry.js.map +1 -0
  101. package/dist/index.d.ts +36 -0
  102. package/dist/index.d.ts.map +1 -0
  103. package/dist/index.js +35 -0
  104. package/dist/index.js.map +1 -0
  105. package/dist/invoke-policy.d.ts +34 -0
  106. package/dist/invoke-policy.d.ts.map +1 -0
  107. package/dist/invoke-policy.js +72 -0
  108. package/dist/invoke-policy.js.map +1 -0
  109. package/dist/invoke-runtime-config.d.ts +4 -0
  110. package/dist/invoke-runtime-config.d.ts.map +1 -0
  111. package/dist/invoke-runtime-config.js +15 -0
  112. package/dist/invoke-runtime-config.js.map +1 -0
  113. package/dist/jobs/in-memory-job-registry.d.ts +21 -0
  114. package/dist/jobs/in-memory-job-registry.d.ts.map +1 -0
  115. package/dist/jobs/in-memory-job-registry.js +44 -0
  116. package/dist/jobs/in-memory-job-registry.js.map +1 -0
  117. package/dist/logger.d.ts +9 -0
  118. package/dist/logger.d.ts.map +1 -0
  119. package/dist/logger.js +17 -0
  120. package/dist/logger.js.map +1 -0
  121. package/dist/openapi/registry-to-openapi.d.ts +11 -0
  122. package/dist/openapi/registry-to-openapi.d.ts.map +1 -0
  123. package/dist/openapi/registry-to-openapi.js +61 -0
  124. package/dist/openapi/registry-to-openapi.js.map +1 -0
  125. package/dist/registry-state.d.ts +107 -0
  126. package/dist/registry-state.d.ts.map +1 -0
  127. package/dist/registry-state.js +302 -0
  128. package/dist/registry-state.js.map +1 -0
  129. package/dist/return.d.ts +14 -0
  130. package/dist/return.d.ts.map +1 -0
  131. package/dist/return.js +107 -0
  132. package/dist/return.js.map +1 -0
  133. package/dist/rpc.d.ts +7 -0
  134. package/dist/rpc.d.ts.map +1 -0
  135. package/dist/rpc.js +287 -0
  136. package/dist/rpc.js.map +1 -0
  137. package/dist/serialize-rpc-result.d.ts +38 -0
  138. package/dist/serialize-rpc-result.d.ts.map +1 -0
  139. package/dist/serialize-rpc-result.js +132 -0
  140. package/dist/serialize-rpc-result.js.map +1 -0
  141. package/dist/session-store.d.ts +9 -0
  142. package/dist/session-store.d.ts.map +1 -0
  143. package/dist/session-store.js +19 -0
  144. package/dist/session-store.js.map +1 -0
  145. package/dist/source-utils.d.ts +19 -0
  146. package/dist/source-utils.d.ts.map +1 -0
  147. package/dist/source-utils.js +65 -0
  148. package/dist/source-utils.js.map +1 -0
  149. package/dist/transport/remote-bridge-cli.d.ts +2 -0
  150. package/dist/transport/remote-bridge-cli.d.ts.map +1 -0
  151. package/dist/transport/remote-bridge-cli.js +12 -0
  152. package/dist/transport/remote-bridge-cli.js.map +1 -0
  153. package/dist/transport/remote-inspector-bridge.d.ts +18 -0
  154. package/dist/transport/remote-inspector-bridge.d.ts.map +1 -0
  155. package/dist/transport/remote-inspector-bridge.js +71 -0
  156. package/dist/transport/remote-inspector-bridge.js.map +1 -0
  157. package/dist/transport/socket-io-playground.d.ts +78 -0
  158. package/dist/transport/socket-io-playground.d.ts.map +1 -0
  159. package/dist/transport/socket-io-playground.js +875 -0
  160. package/dist/transport/socket-io-playground.js.map +1 -0
  161. package/dist/transport/socket-io.d.ts +4 -0
  162. package/dist/transport/socket-io.d.ts.map +1 -0
  163. package/dist/transport/socket-io.js +4 -0
  164. package/dist/transport/socket-io.js.map +1 -0
  165. package/dist/transport/ws-server.d.ts +42 -0
  166. package/dist/transport/ws-server.d.ts.map +1 -0
  167. package/dist/transport/ws-server.js +429 -0
  168. package/dist/transport/ws-server.js.map +1 -0
  169. package/dist/type-string-normalize.d.ts +24 -0
  170. package/dist/type-string-normalize.d.ts.map +1 -0
  171. package/dist/type-string-normalize.js +178 -0
  172. package/dist/type-string-normalize.js.map +1 -0
  173. package/dist/types.d.ts +218 -0
  174. package/dist/types.d.ts.map +1 -0
  175. package/dist/types.js +2 -0
  176. package/dist/types.js.map +1 -0
  177. package/dist/upload/fetch-file-url.d.ts +24 -0
  178. package/dist/upload/fetch-file-url.d.ts.map +1 -0
  179. package/dist/upload/fetch-file-url.js +130 -0
  180. package/dist/upload/fetch-file-url.js.map +1 -0
  181. package/dist/upload/host-minio-client.d.ts +30 -0
  182. package/dist/upload/host-minio-client.d.ts.map +1 -0
  183. package/dist/upload/host-minio-client.js +56 -0
  184. package/dist/upload/host-minio-client.js.map +1 -0
  185. package/dist/upload/materialize.d.ts +110 -0
  186. package/dist/upload/materialize.d.ts.map +1 -0
  187. package/dist/upload/materialize.js +466 -0
  188. package/dist/upload/materialize.js.map +1 -0
  189. package/dist/upload/upload-store.d.ts +44 -0
  190. package/dist/upload/upload-store.d.ts.map +1 -0
  191. package/dist/upload/upload-store.js +86 -0
  192. package/dist/upload/upload-store.js.map +1 -0
  193. package/dist/validate-params-json-schema.d.ts +13 -0
  194. package/dist/validate-params-json-schema.d.ts.map +1 -0
  195. package/dist/validate-params-json-schema.js +37 -0
  196. package/dist/validate-params-json-schema.js.map +1 -0
  197. package/dist/validate-return-json-schema.d.ts +9 -0
  198. package/dist/validate-return-json-schema.d.ts.map +1 -0
  199. package/dist/validate-return-json-schema.js +33 -0
  200. package/dist/validate-return-json-schema.js.map +1 -0
  201. package/package.json +63 -0
@@ -0,0 +1,20 @@
1
+ import type { CompilerOptions } from 'typescript';
2
+ import { type GetAllTsFilesOptions } from './ast/get-all-ts-files.js';
3
+ import type { ExpandTypeOptions } from './ast/type-expand.js';
4
+ export type CatalogFingerprintInput = {
5
+ scanRoots: string[];
6
+ getAllTsFilesOptions?: GetAllTsFilesOptions;
7
+ compilerOptions?: CompilerOptions;
8
+ expandParamTypes?: boolean;
9
+ expandParamTypesOptions?: ExpandTypeOptions;
10
+ redactBodies?: boolean;
11
+ protocolVersion?: number;
12
+ };
13
+ /**
14
+ * Compute a stable fingerprint for the catalog bootstrap inputs.
15
+ *
16
+ * This is meant to be fast (mtime+size), so the server can skip running the
17
+ * full AST bootstrap when nothing relevant changed.
18
+ */
19
+ export declare function computeCatalogFingerprint(input: CatalogFingerprintInput): string;
20
+ //# sourceMappingURL=catalog-fingerprint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog-fingerprint.d.ts","sourceRoot":"","sources":["../src/catalog-fingerprint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGjD,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,MAAM,MAAM,uBAAuB,GAAG;IACrC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,uBAAuB,CAAC,EAAE,iBAAiB,CAAA;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAmBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CA6BhF"}
@@ -0,0 +1,57 @@
1
+ import crypto from 'node:crypto';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { PROTOCOL_VERSION } from './types.js';
5
+ import { getAllTsFiles } from './ast/get-all-ts-files.js';
6
+ function stableStringify(value) {
7
+ if (value === null)
8
+ return 'null';
9
+ const t = typeof value;
10
+ if (t === 'string')
11
+ return JSON.stringify(value);
12
+ if (t === 'number' || t === 'boolean')
13
+ return String(value);
14
+ if (t !== 'object')
15
+ return JSON.stringify(String(value));
16
+ if (Array.isArray(value))
17
+ return `[${value.map(stableStringify).join(',')}]`;
18
+ const obj = value;
19
+ const keys = Object.keys(obj).sort();
20
+ return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(',')}}`;
21
+ }
22
+ function normalizeRoot(p) {
23
+ return path.resolve(p);
24
+ }
25
+ /**
26
+ * Compute a stable fingerprint for the catalog bootstrap inputs.
27
+ *
28
+ * This is meant to be fast (mtime+size), so the server can skip running the
29
+ * full AST bootstrap when nothing relevant changed.
30
+ */
31
+ export function computeCatalogFingerprint(input) {
32
+ const scanRoots = (input.scanRoots ?? []).map(normalizeRoot).sort();
33
+ if (scanRoots.length === 0) {
34
+ throw new Error('computeCatalogFingerprint: scanRoots must include at least one directory');
35
+ }
36
+ const files = [...new Set(scanRoots.flatMap((r) => getAllTsFiles(r, input.getAllTsFilesOptions)))];
37
+ files.sort();
38
+ const fileStats = files.map((filePath) => {
39
+ const abs = path.resolve(filePath);
40
+ const st = fs.statSync(abs);
41
+ return { path: abs, mtimeMs: st.mtimeMs, size: st.size };
42
+ });
43
+ const payload = {
44
+ version: 1,
45
+ protocolVersion: input.protocolVersion ?? Number(PROTOCOL_VERSION),
46
+ scanRoots,
47
+ getAllTsFilesOptions: input.getAllTsFilesOptions ?? null,
48
+ compilerOptions: input.compilerOptions ?? null,
49
+ expandParamTypes: input.expandParamTypes ?? null,
50
+ expandParamTypesOptions: input.expandParamTypesOptions ?? null,
51
+ redactBodies: input.redactBodies ?? null,
52
+ files: fileStats,
53
+ };
54
+ const text = stableStringify(payload);
55
+ return crypto.createHash('sha256').update(text).digest('hex');
56
+ }
57
+ //# sourceMappingURL=catalog-fingerprint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog-fingerprint.js","sourceRoot":"","sources":["../src/catalog-fingerprint.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import ts from 'typescript';
2
+ import { type GetAllTsFilesOptions } from '../ast/get-all-ts-files.js';
3
+ import type { RegistryEntry } from '../types.js';
4
+ import type { CandidateRef, CoverageCandidates } from './types.js';
5
+ export interface CoverageSummaryCounts {
6
+ total: number;
7
+ wrapped: number;
8
+ left: number;
9
+ }
10
+ export interface CoverageReport {
11
+ summary: {
12
+ middleware: CoverageSummaryCounts;
13
+ controllers: CoverageSummaryCounts;
14
+ services: CoverageSummaryCounts;
15
+ };
16
+ left: {
17
+ middleware: CandidateRef[];
18
+ controllers: CandidateRef[];
19
+ services: CandidateRef[];
20
+ };
21
+ meta: {
22
+ scanRoots: string[];
23
+ filesScanned: number;
24
+ generatedAt: string;
25
+ protocolVersion: number;
26
+ unresolvedHandlers: number;
27
+ nodesVisited: number;
28
+ };
29
+ }
30
+ export interface ComputeCoverageOptions {
31
+ scanRoots: string[];
32
+ registrySnapshot: Record<string, RegistryEntry>;
33
+ getAllTsFilesOptions?: GetAllTsFilesOptions;
34
+ compilerOptions?: ts.CompilerOptions;
35
+ maxServiceNodes?: number;
36
+ }
37
+ export declare function computeCoverageReport(options: ComputeCoverageOptions): {
38
+ candidates: CoverageCandidates;
39
+ report: CoverageReport;
40
+ };
41
+ //# sourceMappingURL=compute-coverage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compute-coverage.d.ts","sourceRoot":"","sources":["../../src/coverage/compute-coverage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAa,MAAM,YAAY,CAAA;AAE7E,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE;QACR,UAAU,EAAE,qBAAqB,CAAA;QACjC,WAAW,EAAE,qBAAqB,CAAA;QAClC,QAAQ,EAAE,qBAAqB,CAAA;KAC/B,CAAA;IACD,IAAI,EAAE;QACL,UAAU,EAAE,YAAY,EAAE,CAAA;QAC1B,WAAW,EAAE,YAAY,EAAE,CAAA;QAC3B,QAAQ,EAAE,YAAY,EAAE,CAAA;KACxB,CAAA;IACD,IAAI,EAAE;QACL,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,eAAe,EAAE,MAAM,CAAA;QACvB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,YAAY,EAAE,MAAM,CAAA;KACpB,CAAA;CACD;AAED,MAAM,WAAW,sBAAsB;IACtC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC/C,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AA+KD,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,sBAAsB,GAC7B;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAiF5D"}
@@ -0,0 +1,229 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import ts from 'typescript';
4
+ import { getAllTsFiles } from '../ast/get-all-ts-files.js';
5
+ import { scanExpressCandidates } from './scan-express-candidates.js';
6
+ import { scanReachableServices } from './scan-reachable-services.js';
7
+ function loadCompilerOptions(rootDir, extra) {
8
+ const configPath = ts.findConfigFile(rootDir, ts.sys.fileExists, 'tsconfig.json');
9
+ if (!configPath) {
10
+ return {
11
+ ...(extra ?? {}),
12
+ target: ts.ScriptTarget.ES2022,
13
+ module: ts.ModuleKind.NodeNext,
14
+ moduleResolution: ts.ModuleResolutionKind.NodeNext,
15
+ strict: true,
16
+ };
17
+ }
18
+ const read = ts.readConfigFile(configPath, (p) => fs.readFileSync(p, 'utf8'));
19
+ if (read.error) {
20
+ throw new Error(ts.formatDiagnostic(read.error, ts.createCompilerHost({})));
21
+ }
22
+ const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, path.dirname(configPath), undefined, configPath);
23
+ return { ...parsed.options, ...extra };
24
+ }
25
+ function posToTsPosition(source, p) {
26
+ return ts.getPositionOfLineAndCharacter(source, p.line - 1, p.col - 1);
27
+ }
28
+ function findSmallestNodeContainingPosition(source, position) {
29
+ let found = null;
30
+ const visit = (n) => {
31
+ const start = n.getStart(source, false);
32
+ const end = n.getEnd();
33
+ if (position < start || position > end)
34
+ return;
35
+ found = n;
36
+ ts.forEachChild(n, visit);
37
+ };
38
+ visit(source);
39
+ return found;
40
+ }
41
+ function getStringLiteralText(node) {
42
+ if (!node)
43
+ return null;
44
+ if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node))
45
+ return node.text;
46
+ return null;
47
+ }
48
+ function hasDecoratorNamed(node, name) {
49
+ const mods = node.modifiers;
50
+ if (!mods)
51
+ return false;
52
+ return mods.some((m) => {
53
+ if (!ts.isDecorator(m))
54
+ return false;
55
+ const expr = m.expression;
56
+ if (ts.isIdentifier(expr))
57
+ return expr.text === name;
58
+ if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression))
59
+ return expr.expression.text === name;
60
+ return false;
61
+ });
62
+ }
63
+ function resolveAliasedSymbol(checker, sym) {
64
+ if (!sym)
65
+ return null;
66
+ let cur = sym;
67
+ for (let i = 0; i < 10 && cur; i++) {
68
+ if (cur.flags & ts.SymbolFlags.Alias) {
69
+ cur = checker.getAliasedSymbol(cur);
70
+ continue;
71
+ }
72
+ return cur;
73
+ }
74
+ return cur;
75
+ }
76
+ function tryResolveFnKeyFromNode(checker, node) {
77
+ // @Cat method: ClassName.method
78
+ if (ts.isMethodDeclaration(node) && ts.isIdentifier(node.name)) {
79
+ if (hasDecoratorNamed(node, 'Cat')) {
80
+ const cls = node.parent;
81
+ if (ts.isClassDeclaration(cls) && cls.name)
82
+ return `${cls.name.text}.${node.name.text}`;
83
+ }
84
+ }
85
+ // Identifier used in routing, e.g. `requireUser`, where definition is:
86
+ // const requireUser = cat('AuthMiddleware.requireUser', fn)
87
+ if (ts.isIdentifier(node)) {
88
+ const sym = resolveAliasedSymbol(checker, checker.getSymbolAtLocation(node));
89
+ const decl = sym?.getDeclarations?.()?.[0];
90
+ if (decl && ts.isVariableDeclaration(decl) && decl.initializer) {
91
+ const init = decl.initializer;
92
+ if (ts.isCallExpression(init) && ts.isIdentifier(init.expression) && init.expression.text === 'cat') {
93
+ return getStringLiteralText(init.arguments[0]);
94
+ }
95
+ }
96
+ }
97
+ // Property access used in routing, e.g. `ctrl.create` or `ctrl.create.bind(ctrl)`
98
+ // Try to resolve the symbol to a method declaration and check for @Cat.
99
+ if (ts.isPropertyAccessExpression(node)) {
100
+ const sym = resolveAliasedSymbol(checker, checker.getSymbolAtLocation(node.name));
101
+ const decl = sym?.getDeclarations?.()?.[0];
102
+ if (decl && ts.isMethodDeclaration(decl) && ts.isIdentifier(decl.name)) {
103
+ if (hasDecoratorNamed(decl, 'Cat')) {
104
+ const cls = decl.parent;
105
+ if (ts.isClassDeclaration(cls) && cls.name)
106
+ return `${cls.name.text}.${decl.name.text}`;
107
+ }
108
+ }
109
+ }
110
+ // Bind call: `ctrl.create.bind(ctrl)` => underlying `ctrl.create`
111
+ if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)) {
112
+ if (node.expression.name.text === 'bind') {
113
+ const inner = node.expression.expression;
114
+ if (ts.isPropertyAccessExpression(inner) || ts.isIdentifier(inner)) {
115
+ return tryResolveFnKeyFromNode(checker, inner);
116
+ }
117
+ }
118
+ }
119
+ return null;
120
+ }
121
+ function enrichCandidatesWithResolvedFnKeys(program, candidates) {
122
+ const checker = program.getTypeChecker();
123
+ const out = [];
124
+ for (const c of candidates) {
125
+ const source = program.getSourceFile(c.source.file);
126
+ if (!source) {
127
+ out.push(c);
128
+ continue;
129
+ }
130
+ const position = posToTsPosition(source, c.source);
131
+ const node = findSmallestNodeContainingPosition(source, position);
132
+ if (!node) {
133
+ out.push(c);
134
+ continue;
135
+ }
136
+ const resolved = tryResolveFnKeyFromNode(checker, node);
137
+ out.push({
138
+ ...c,
139
+ resolvedFnKey: resolved ?? c.resolvedFnKey ?? null,
140
+ });
141
+ }
142
+ return out;
143
+ }
144
+ function splitWrappedLeft(items, wrappedFnKeys) {
145
+ const wrapped = [];
146
+ const left = [];
147
+ for (const c of items) {
148
+ const key = c.resolvedFnKey ?? null;
149
+ if (key && wrappedFnKeys.has(key))
150
+ wrapped.push(c);
151
+ else
152
+ left.push(c);
153
+ }
154
+ return { wrapped, left };
155
+ }
156
+ export function computeCoverageReport(options) {
157
+ const scanRoots = options.scanRoots;
158
+ if (scanRoots.length === 0) {
159
+ throw new Error('computeCoverageReport: scanRoots must include at least one directory');
160
+ }
161
+ const scanRoot = scanRoots[0];
162
+ // 1) Candidates (HTTP)
163
+ const scanOpts = {
164
+ getAllTsFilesOptions: options.getAllTsFilesOptions,
165
+ compilerOptions: options.compilerOptions,
166
+ ownedRoots: options.scanRoots,
167
+ };
168
+ const http = scanExpressCandidates(scanRoot, scanOpts);
169
+ // 2) Reachable services
170
+ const svc = scanReachableServices(scanRoot, {
171
+ ...scanOpts,
172
+ maxNodes: options.maxServiceNodes,
173
+ });
174
+ const wrappedFnKeys = new Set(Object.keys(options.registrySnapshot));
175
+ // 3) Build a TS program so we can infer fnKeys for unwrapped route handlers too.
176
+ const files = [...new Set(scanRoots.flatMap((r) => getAllTsFiles(r, options.getAllTsFilesOptions)))];
177
+ const compilerOptions = loadCompilerOptions(scanRoot, options.compilerOptions);
178
+ const program = ts.createProgram(files, compilerOptions);
179
+ const middleware = enrichCandidatesWithResolvedFnKeys(program, http.middleware);
180
+ const controllers = enrichCandidatesWithResolvedFnKeys(program, http.controllers);
181
+ const services = enrichCandidatesWithResolvedFnKeys(program, svc.services);
182
+ const mwSplit = splitWrappedLeft(middleware, wrappedFnKeys);
183
+ const ctrlSplit = splitWrappedLeft(controllers, wrappedFnKeys);
184
+ const svcSplit = splitWrappedLeft(services, wrappedFnKeys);
185
+ const candidates = {
186
+ middleware,
187
+ controllers,
188
+ services,
189
+ meta: {
190
+ filesScanned: files.length,
191
+ unresolvedHandlers: http.meta.unresolvedHandlers,
192
+ droppedThirdParty: http.meta.droppedThirdParty,
193
+ },
194
+ };
195
+ const report = {
196
+ summary: {
197
+ middleware: {
198
+ total: middleware.length,
199
+ wrapped: mwSplit.wrapped.length,
200
+ left: mwSplit.left.length,
201
+ },
202
+ controllers: {
203
+ total: controllers.length,
204
+ wrapped: ctrlSplit.wrapped.length,
205
+ left: ctrlSplit.left.length,
206
+ },
207
+ services: {
208
+ total: services.length,
209
+ wrapped: svcSplit.wrapped.length,
210
+ left: svcSplit.left.length,
211
+ },
212
+ },
213
+ left: {
214
+ middleware: mwSplit.left,
215
+ controllers: ctrlSplit.left,
216
+ services: svcSplit.left,
217
+ },
218
+ meta: {
219
+ scanRoots,
220
+ filesScanned: files.length,
221
+ generatedAt: new Date().toISOString(),
222
+ protocolVersion: 0,
223
+ unresolvedHandlers: http.meta.unresolvedHandlers,
224
+ nodesVisited: svc.meta.nodesVisited,
225
+ },
226
+ };
227
+ return { candidates, report };
228
+ }
229
+ //# sourceMappingURL=compute-coverage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compute-coverage.js","sourceRoot":"","sources":["../../src/coverage/compute-coverage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import ts from 'typescript';
2
+ import { type GetAllTsFilesOptions } from '../ast/get-all-ts-files.js';
3
+ import type { CandidateRef } from './types.js';
4
+ export interface ScanAllServiceCandidatesOptions {
5
+ getAllTsFilesOptions?: GetAllTsFilesOptions;
6
+ compilerOptions?: ts.CompilerOptions;
7
+ files?: string[];
8
+ }
9
+ export declare function scanAllServiceCandidates(rootDir: string, options?: ScanAllServiceCandidatesOptions): {
10
+ services: CandidateRef[];
11
+ meta: {
12
+ filesScanned: number;
13
+ };
14
+ };
15
+ //# sourceMappingURL=scan-all-service-candidates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan-all-service-candidates.d.ts","sourceRoot":"","sources":["../../src/coverage/scan-all-service-candidates.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,+BAA+B;IAC/C,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAiDD,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,+BAAoC,GAC3C;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAsC9D"}
@@ -0,0 +1,73 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import ts from 'typescript';
4
+ import { getAllTsFiles } from '../ast/get-all-ts-files.js';
5
+ function loadCompilerOptions(rootDir, extra) {
6
+ const configPath = ts.findConfigFile(rootDir, ts.sys.fileExists, 'tsconfig.json');
7
+ if (!configPath) {
8
+ return {
9
+ ...(extra ?? {}),
10
+ target: ts.ScriptTarget.ES2022,
11
+ module: ts.ModuleKind.NodeNext,
12
+ moduleResolution: ts.ModuleResolutionKind.NodeNext,
13
+ strict: true,
14
+ };
15
+ }
16
+ const read = ts.readConfigFile(configPath, (p) => fs.readFileSync(p, 'utf8'));
17
+ if (read.error) {
18
+ throw new Error(ts.formatDiagnostic(read.error, ts.createCompilerHost({})));
19
+ }
20
+ const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, path.dirname(configPath), undefined, configPath);
21
+ return { ...parsed.options, ...extra };
22
+ }
23
+ function posOf(source, node) {
24
+ const lc = source.getLineAndCharacterOfPosition(node.getStart(source, false));
25
+ return {
26
+ file: source.fileName,
27
+ line: lc.line + 1,
28
+ col: lc.character + 1,
29
+ };
30
+ }
31
+ function classNameOfMethod(m) {
32
+ const p = m.parent;
33
+ if (ts.isClassDeclaration(p) && p.name)
34
+ return p.name.text;
35
+ return null;
36
+ }
37
+ function isServiceClassName(name) {
38
+ return name.endsWith('Service') || name.endsWith('Services');
39
+ }
40
+ export function scanAllServiceCandidates(rootDir, options = {}) {
41
+ const files = options.files ?? getAllTsFiles(rootDir, options.getAllTsFilesOptions);
42
+ const compilerOptions = loadCompilerOptions(rootDir, options.compilerOptions);
43
+ const program = ts.createProgram(files, compilerOptions);
44
+ const services = [];
45
+ const seen = new Set();
46
+ for (const filePath of files) {
47
+ const source = program.getSourceFile(filePath);
48
+ if (!source)
49
+ continue;
50
+ const visit = (node) => {
51
+ if (ts.isMethodDeclaration(node) && ts.isIdentifier(node.name)) {
52
+ const cls = classNameOfMethod(node);
53
+ if (cls && isServiceClassName(cls)) {
54
+ const id = `${source.fileName}:${node.pos}:${node.end}`;
55
+ if (!seen.has(id)) {
56
+ seen.add(id);
57
+ services.push({
58
+ kind: 'service',
59
+ name: `${cls}.${node.name.text}`,
60
+ source: posOf(source, node),
61
+ resolvedFnKey: `${cls}.${node.name.text}`,
62
+ _nodeKind: node.kind,
63
+ });
64
+ }
65
+ }
66
+ }
67
+ ts.forEachChild(node, visit);
68
+ };
69
+ visit(source);
70
+ }
71
+ return { services, meta: { filesScanned: files.length } };
72
+ }
73
+ //# sourceMappingURL=scan-all-service-candidates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan-all-service-candidates.js","sourceRoot":"","sources":["../../src/coverage/scan-all-service-candidates.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import ts from 'typescript';
2
+ import { type GetAllTsFilesOptions } from '../ast/get-all-ts-files.js';
3
+ import type { CoverageCandidates } from './types.js';
4
+ export interface ScanExpressCandidatesOptions {
5
+ getAllTsFilesOptions?: GetAllTsFilesOptions;
6
+ /** Extra compiler options merged over parsed config */
7
+ compilerOptions?: ts.CompilerOptions;
8
+ /** If set, only these files are in the program (for tests / narrow scans) */
9
+ files?: string[];
10
+ /**
11
+ * If set, only keep handlers whose resolved declaration source file is under one of these roots.
12
+ * Used to drop third-party middleware calls like `express.json()` from coverage totals.
13
+ */
14
+ ownedRoots?: string[];
15
+ }
16
+ export declare function scanExpressCandidates(rootDir: string, options?: ScanExpressCandidatesOptions): CoverageCandidates;
17
+ //# sourceMappingURL=scan-express-candidates.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scan-express-candidates.d.ts","sourceRoot":"","sources":["../../src/coverage/scan-express-candidates.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACrF,OAAO,KAAK,EAAgB,kBAAkB,EAAwB,MAAM,YAAY,CAAA;AAExF,MAAM,WAAW,4BAA4B;IAC5C,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,uDAAuD;IACvD,eAAe,CAAC,EAAE,EAAE,CAAC,eAAe,CAAA;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AA+MD,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,4BAAiC,GACxC,kBAAkB,CA0HpB"}