@avi770/testteam 1.2.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 (325) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +167 -0
  4. package/agents/01-analyst.ts +100 -0
  5. package/agents/02-seed-architect.ts +59 -0
  6. package/agents/03-test-generator.ts +191 -0
  7. package/agents/04-unit-runner.ts +160 -0
  8. package/agents/05-browser-crawler.ts +790 -0
  9. package/agents/06-api-exerciser.ts +311 -0
  10. package/agents/07-security-scout.ts +188 -0
  11. package/agents/08-a11y-guardian.ts +212 -0
  12. package/agents/09-healer.ts +228 -0
  13. package/agents/10-reporter.ts +266 -0
  14. package/agents/11-fixer.ts +253 -0
  15. package/agents/12-ux-inspector.ts +444 -0
  16. package/agents/13-performance-profiler.ts +271 -0
  17. package/agents/14-data-integrity-auditor.ts +417 -0
  18. package/agents/15-regression-sentinel.ts +307 -0
  19. package/agents/16-chaos-agent.ts +228 -0
  20. package/agents/17-documentation-validator.ts +266 -0
  21. package/agents/18-integration-watchdog.ts +178 -0
  22. package/agents/19-tenant-isolation-auditor.ts +199 -0
  23. package/agents/20-workflow-completion-tester.ts +203 -0
  24. package/agents/21-state-session-tester.ts +262 -0
  25. package/agents/22-email-notification-verifier.ts +244 -0
  26. package/agents/23-migration-tester.ts +80 -0
  27. package/agents/__tests__/01-analyst.test.ts +188 -0
  28. package/agents/__tests__/02-seed-architect.test.ts +152 -0
  29. package/agents/__tests__/03-test-generator-full.test.ts +321 -0
  30. package/agents/__tests__/03-test-generator.test.ts +318 -0
  31. package/agents/__tests__/04-unit-runner.test.ts +320 -0
  32. package/agents/__tests__/05-browser-crawler-beta.test.ts +492 -0
  33. package/agents/__tests__/05-browser-crawler-release.test.ts +412 -0
  34. package/agents/__tests__/05-browser-crawler-uat.test.ts +578 -0
  35. package/agents/__tests__/05-browser-crawler.test.ts +518 -0
  36. package/agents/__tests__/06-api-exerciser.test.ts +619 -0
  37. package/agents/__tests__/07-security-scout.test.ts +382 -0
  38. package/agents/__tests__/08-a11y-guardian.test.ts +530 -0
  39. package/agents/__tests__/09-healer.test.ts +384 -0
  40. package/agents/__tests__/10-reporter.test.ts +366 -0
  41. package/agents/__tests__/11-fixer.test.ts +406 -0
  42. package/agents/__tests__/12-ux-inspector-extended.test.ts +465 -0
  43. package/agents/__tests__/12-ux-inspector.test.ts +443 -0
  44. package/agents/__tests__/13-performance-profiler.test.ts +411 -0
  45. package/agents/__tests__/14-data-integrity-auditor-extended.test.ts +573 -0
  46. package/agents/__tests__/14-data-integrity-auditor.test.ts +407 -0
  47. package/agents/__tests__/15-regression-sentinel.test.ts +657 -0
  48. package/agents/__tests__/16-chaos-agent.test.ts +427 -0
  49. package/agents/__tests__/17-documentation-validator.test.ts +402 -0
  50. package/agents/__tests__/18-integration-watchdog.test.ts +263 -0
  51. package/agents/__tests__/19-tenant-isolation-auditor.test.ts +400 -0
  52. package/agents/__tests__/20-workflow-completion-tester.test.ts +586 -0
  53. package/agents/__tests__/21-state-session-tester.test.ts +374 -0
  54. package/agents/__tests__/22-email-notification-verifier.test.ts +441 -0
  55. package/agents/__tests__/23-migration-tester.test.ts +145 -0
  56. package/agents/__tests__/base-agent.test.ts +188 -0
  57. package/agents/__tests__/registry.test.ts +218 -0
  58. package/agents/base-agent.ts +77 -0
  59. package/agents/registry.ts +136 -0
  60. package/baselines/api-schemas/.gitkeep +0 -0
  61. package/baselines/performance/.gitkeep +0 -0
  62. package/baselines/screenshots/.gitkeep +0 -0
  63. package/bin/testteam.js +10 -0
  64. package/core/__tests__/ci-output.test.ts +430 -0
  65. package/core/__tests__/cli.test.ts +387 -0
  66. package/core/__tests__/config.test.ts +78 -0
  67. package/core/__tests__/cost-tracker.test.ts +158 -0
  68. package/core/__tests__/evidence.test.ts +265 -0
  69. package/core/__tests__/fix-loop.test.ts +210 -0
  70. package/core/__tests__/health-check.test.ts +44 -0
  71. package/core/__tests__/init.test.ts +609 -0
  72. package/core/__tests__/integration.test.ts +204 -0
  73. package/core/__tests__/license-gen.test.ts +227 -0
  74. package/core/__tests__/license.test.ts +326 -0
  75. package/core/__tests__/multi-browser.test.ts +278 -0
  76. package/core/__tests__/orchestrator.test.ts +519 -0
  77. package/core/__tests__/phase-gate.test.ts +43 -0
  78. package/core/__tests__/report-html.test.ts +398 -0
  79. package/core/__tests__/report-upload.test.ts +325 -0
  80. package/core/__tests__/run-counter.test.ts +234 -0
  81. package/core/ci-output.ts +240 -0
  82. package/core/cli.ts +232 -0
  83. package/core/config.ts +178 -0
  84. package/core/cost-tracker.ts +59 -0
  85. package/core/evidence.ts +132 -0
  86. package/core/fix-loop.ts +85 -0
  87. package/core/health-check.ts +54 -0
  88. package/core/init.ts +546 -0
  89. package/core/license-gen.ts +212 -0
  90. package/core/license.ts +211 -0
  91. package/core/messages.ts +67 -0
  92. package/core/multi-browser.ts +136 -0
  93. package/core/orchestrator.ts +354 -0
  94. package/core/phase-gate.ts +55 -0
  95. package/core/report-html.ts +657 -0
  96. package/core/report-upload.ts +188 -0
  97. package/core/run-counter.ts +175 -0
  98. package/core/types.ts +57 -0
  99. package/dist/agents/01-analyst.d.ts +11 -0
  100. package/dist/agents/01-analyst.d.ts.map +1 -0
  101. package/dist/agents/01-analyst.js +75 -0
  102. package/dist/agents/01-analyst.js.map +1 -0
  103. package/dist/agents/02-seed-architect.d.ts +11 -0
  104. package/dist/agents/02-seed-architect.d.ts.map +1 -0
  105. package/dist/agents/02-seed-architect.js +51 -0
  106. package/dist/agents/02-seed-architect.js.map +1 -0
  107. package/dist/agents/03-test-generator.d.ts +9 -0
  108. package/dist/agents/03-test-generator.d.ts.map +1 -0
  109. package/dist/agents/03-test-generator.js +167 -0
  110. package/dist/agents/03-test-generator.js.map +1 -0
  111. package/dist/agents/04-unit-runner.d.ts +9 -0
  112. package/dist/agents/04-unit-runner.d.ts.map +1 -0
  113. package/dist/agents/04-unit-runner.js +113 -0
  114. package/dist/agents/04-unit-runner.js.map +1 -0
  115. package/dist/agents/05-browser-crawler.d.ts +30 -0
  116. package/dist/agents/05-browser-crawler.d.ts.map +1 -0
  117. package/dist/agents/05-browser-crawler.js +685 -0
  118. package/dist/agents/05-browser-crawler.js.map +1 -0
  119. package/dist/agents/06-api-exerciser.d.ts +23 -0
  120. package/dist/agents/06-api-exerciser.d.ts.map +1 -0
  121. package/dist/agents/06-api-exerciser.js +253 -0
  122. package/dist/agents/06-api-exerciser.js.map +1 -0
  123. package/dist/agents/07-security-scout.d.ts +11 -0
  124. package/dist/agents/07-security-scout.d.ts.map +1 -0
  125. package/dist/agents/07-security-scout.js +142 -0
  126. package/dist/agents/07-security-scout.js.map +1 -0
  127. package/dist/agents/08-a11y-guardian.d.ts +13 -0
  128. package/dist/agents/08-a11y-guardian.d.ts.map +1 -0
  129. package/dist/agents/08-a11y-guardian.js +176 -0
  130. package/dist/agents/08-a11y-guardian.js.map +1 -0
  131. package/dist/agents/09-healer.d.ts +33 -0
  132. package/dist/agents/09-healer.d.ts.map +1 -0
  133. package/dist/agents/09-healer.js +167 -0
  134. package/dist/agents/09-healer.js.map +1 -0
  135. package/dist/agents/10-reporter.d.ts +26 -0
  136. package/dist/agents/10-reporter.d.ts.map +1 -0
  137. package/dist/agents/10-reporter.js +215 -0
  138. package/dist/agents/10-reporter.js.map +1 -0
  139. package/dist/agents/11-fixer.d.ts +26 -0
  140. package/dist/agents/11-fixer.d.ts.map +1 -0
  141. package/dist/agents/11-fixer.js +195 -0
  142. package/dist/agents/11-fixer.js.map +1 -0
  143. package/dist/agents/12-ux-inspector.d.ts +15 -0
  144. package/dist/agents/12-ux-inspector.d.ts.map +1 -0
  145. package/dist/agents/12-ux-inspector.js +364 -0
  146. package/dist/agents/12-ux-inspector.js.map +1 -0
  147. package/dist/agents/13-performance-profiler.d.ts +13 -0
  148. package/dist/agents/13-performance-profiler.d.ts.map +1 -0
  149. package/dist/agents/13-performance-profiler.js +216 -0
  150. package/dist/agents/13-performance-profiler.js.map +1 -0
  151. package/dist/agents/14-data-integrity-auditor.d.ts +12 -0
  152. package/dist/agents/14-data-integrity-auditor.d.ts.map +1 -0
  153. package/dist/agents/14-data-integrity-auditor.js +356 -0
  154. package/dist/agents/14-data-integrity-auditor.js.map +1 -0
  155. package/dist/agents/15-regression-sentinel.d.ts +25 -0
  156. package/dist/agents/15-regression-sentinel.d.ts.map +1 -0
  157. package/dist/agents/15-regression-sentinel.js +251 -0
  158. package/dist/agents/15-regression-sentinel.js.map +1 -0
  159. package/dist/agents/16-chaos-agent.d.ts +9 -0
  160. package/dist/agents/16-chaos-agent.d.ts.map +1 -0
  161. package/dist/agents/16-chaos-agent.js +207 -0
  162. package/dist/agents/16-chaos-agent.js.map +1 -0
  163. package/dist/agents/17-documentation-validator.d.ts +31 -0
  164. package/dist/agents/17-documentation-validator.d.ts.map +1 -0
  165. package/dist/agents/17-documentation-validator.js +246 -0
  166. package/dist/agents/17-documentation-validator.js.map +1 -0
  167. package/dist/agents/18-integration-watchdog.d.ts +10 -0
  168. package/dist/agents/18-integration-watchdog.d.ts.map +1 -0
  169. package/dist/agents/18-integration-watchdog.js +138 -0
  170. package/dist/agents/18-integration-watchdog.js.map +1 -0
  171. package/dist/agents/19-tenant-isolation-auditor.d.ts +9 -0
  172. package/dist/agents/19-tenant-isolation-auditor.d.ts.map +1 -0
  173. package/dist/agents/19-tenant-isolation-auditor.js +166 -0
  174. package/dist/agents/19-tenant-isolation-auditor.js.map +1 -0
  175. package/dist/agents/20-workflow-completion-tester.d.ts +12 -0
  176. package/dist/agents/20-workflow-completion-tester.d.ts.map +1 -0
  177. package/dist/agents/20-workflow-completion-tester.js +159 -0
  178. package/dist/agents/20-workflow-completion-tester.js.map +1 -0
  179. package/dist/agents/21-state-session-tester.d.ts +10 -0
  180. package/dist/agents/21-state-session-tester.d.ts.map +1 -0
  181. package/dist/agents/21-state-session-tester.js +233 -0
  182. package/dist/agents/21-state-session-tester.js.map +1 -0
  183. package/dist/agents/22-email-notification-verifier.d.ts +11 -0
  184. package/dist/agents/22-email-notification-verifier.d.ts.map +1 -0
  185. package/dist/agents/22-email-notification-verifier.js +199 -0
  186. package/dist/agents/22-email-notification-verifier.js.map +1 -0
  187. package/dist/agents/23-migration-tester.d.ts +10 -0
  188. package/dist/agents/23-migration-tester.d.ts.map +1 -0
  189. package/dist/agents/23-migration-tester.js +74 -0
  190. package/dist/agents/23-migration-tester.js.map +1 -0
  191. package/dist/agents/base-agent.d.ts +19 -0
  192. package/dist/agents/base-agent.d.ts.map +1 -0
  193. package/dist/agents/base-agent.js +67 -0
  194. package/dist/agents/base-agent.js.map +1 -0
  195. package/dist/agents/registry.d.ts +29 -0
  196. package/dist/agents/registry.d.ts.map +1 -0
  197. package/dist/agents/registry.js +117 -0
  198. package/dist/agents/registry.js.map +1 -0
  199. package/dist/core/ci-output.d.ts +35 -0
  200. package/dist/core/ci-output.d.ts.map +1 -0
  201. package/dist/core/ci-output.js +193 -0
  202. package/dist/core/ci-output.js.map +1 -0
  203. package/dist/core/cli.d.ts +11 -0
  204. package/dist/core/cli.d.ts.map +1 -0
  205. package/dist/core/cli.js +197 -0
  206. package/dist/core/cli.js.map +1 -0
  207. package/dist/core/config.d.ts +111 -0
  208. package/dist/core/config.d.ts.map +1 -0
  209. package/dist/core/config.js +42 -0
  210. package/dist/core/config.js.map +1 -0
  211. package/dist/core/cost-tracker.d.ts +22 -0
  212. package/dist/core/cost-tracker.d.ts.map +1 -0
  213. package/dist/core/cost-tracker.js +41 -0
  214. package/dist/core/cost-tracker.js.map +1 -0
  215. package/dist/core/evidence.d.ts +28 -0
  216. package/dist/core/evidence.d.ts.map +1 -0
  217. package/dist/core/evidence.js +95 -0
  218. package/dist/core/evidence.js.map +1 -0
  219. package/dist/core/fix-loop.d.ts +29 -0
  220. package/dist/core/fix-loop.d.ts.map +1 -0
  221. package/dist/core/fix-loop.js +70 -0
  222. package/dist/core/fix-loop.js.map +1 -0
  223. package/dist/core/health-check.d.ts +21 -0
  224. package/dist/core/health-check.d.ts.map +1 -0
  225. package/dist/core/health-check.js +26 -0
  226. package/dist/core/health-check.js.map +1 -0
  227. package/dist/core/init.d.ts +2 -0
  228. package/dist/core/init.d.ts.map +1 -0
  229. package/dist/core/init.js +435 -0
  230. package/dist/core/init.js.map +1 -0
  231. package/dist/core/license-gen.d.ts +12 -0
  232. package/dist/core/license-gen.d.ts.map +1 -0
  233. package/dist/core/license-gen.js +169 -0
  234. package/dist/core/license-gen.js.map +1 -0
  235. package/dist/core/license.d.ts +33 -0
  236. package/dist/core/license.d.ts.map +1 -0
  237. package/dist/core/license.js +170 -0
  238. package/dist/core/license.js.map +1 -0
  239. package/dist/core/messages.d.ts +10 -0
  240. package/dist/core/messages.d.ts.map +1 -0
  241. package/dist/core/messages.js +47 -0
  242. package/dist/core/messages.js.map +1 -0
  243. package/dist/core/multi-browser.d.ts +36 -0
  244. package/dist/core/multi-browser.d.ts.map +1 -0
  245. package/dist/core/multi-browser.js +88 -0
  246. package/dist/core/multi-browser.js.map +1 -0
  247. package/dist/core/orchestrator.d.ts +48 -0
  248. package/dist/core/orchestrator.d.ts.map +1 -0
  249. package/dist/core/orchestrator.js +291 -0
  250. package/dist/core/orchestrator.js.map +1 -0
  251. package/dist/core/phase-gate.d.ts +4 -0
  252. package/dist/core/phase-gate.d.ts.map +1 -0
  253. package/dist/core/phase-gate.js +39 -0
  254. package/dist/core/phase-gate.js.map +1 -0
  255. package/dist/core/report-html.d.ts +9 -0
  256. package/dist/core/report-html.d.ts.map +1 -0
  257. package/dist/core/report-html.js +617 -0
  258. package/dist/core/report-html.js.map +1 -0
  259. package/dist/core/report-upload.d.ts +16 -0
  260. package/dist/core/report-upload.d.ts.map +1 -0
  261. package/dist/core/report-upload.js +124 -0
  262. package/dist/core/report-upload.js.map +1 -0
  263. package/dist/core/run-counter.d.ts +40 -0
  264. package/dist/core/run-counter.d.ts.map +1 -0
  265. package/dist/core/run-counter.js +120 -0
  266. package/dist/core/run-counter.js.map +1 -0
  267. package/dist/core/types.d.ts +53 -0
  268. package/dist/core/types.d.ts.map +1 -0
  269. package/dist/core/types.js +2 -0
  270. package/dist/core/types.js.map +1 -0
  271. package/dist/helpers/api-client.d.ts +30 -0
  272. package/dist/helpers/api-client.d.ts.map +1 -0
  273. package/dist/helpers/api-client.js +77 -0
  274. package/dist/helpers/api-client.js.map +1 -0
  275. package/dist/helpers/element-discovery.d.ts +18 -0
  276. package/dist/helpers/element-discovery.d.ts.map +1 -0
  277. package/dist/helpers/element-discovery.js +82 -0
  278. package/dist/helpers/element-discovery.js.map +1 -0
  279. package/dist/helpers/env-resolver.d.ts +29 -0
  280. package/dist/helpers/env-resolver.d.ts.map +1 -0
  281. package/dist/helpers/env-resolver.js +51 -0
  282. package/dist/helpers/env-resolver.js.map +1 -0
  283. package/dist/helpers/form-filler.d.ts +13 -0
  284. package/dist/helpers/form-filler.d.ts.map +1 -0
  285. package/dist/helpers/form-filler.js +98 -0
  286. package/dist/helpers/form-filler.js.map +1 -0
  287. package/dist/helpers/modal-handler.d.ts +16 -0
  288. package/dist/helpers/modal-handler.d.ts.map +1 -0
  289. package/dist/helpers/modal-handler.js +95 -0
  290. package/dist/helpers/modal-handler.js.map +1 -0
  291. package/dist/helpers/navigation.d.ts +37 -0
  292. package/dist/helpers/navigation.d.ts.map +1 -0
  293. package/dist/helpers/navigation.js +83 -0
  294. package/dist/helpers/navigation.js.map +1 -0
  295. package/dist/helpers/quality-gate.d.ts +17 -0
  296. package/dist/helpers/quality-gate.d.ts.map +1 -0
  297. package/dist/helpers/quality-gate.js +144 -0
  298. package/dist/helpers/quality-gate.js.map +1 -0
  299. package/dist/helpers/screenshot.d.ts +24 -0
  300. package/dist/helpers/screenshot.d.ts.map +1 -0
  301. package/dist/helpers/screenshot.js +76 -0
  302. package/dist/helpers/screenshot.js.map +1 -0
  303. package/dist/helpers/seed-validator.d.ts +15 -0
  304. package/dist/helpers/seed-validator.d.ts.map +1 -0
  305. package/dist/helpers/seed-validator.js +53 -0
  306. package/dist/helpers/seed-validator.js.map +1 -0
  307. package/helpers/__tests__/api-client.test.ts +199 -0
  308. package/helpers/__tests__/element-discovery.test.ts +202 -0
  309. package/helpers/__tests__/form-filler-extended.test.ts +212 -0
  310. package/helpers/__tests__/form-filler.test.ts +99 -0
  311. package/helpers/__tests__/modal-handler.test.ts +152 -0
  312. package/helpers/__tests__/navigation.test.ts +214 -0
  313. package/helpers/__tests__/quality-gate.test.ts +117 -0
  314. package/helpers/__tests__/screenshot.test.ts +139 -0
  315. package/helpers/__tests__/seed-validator.test.ts +114 -0
  316. package/helpers/api-client.ts +111 -0
  317. package/helpers/element-discovery.ts +105 -0
  318. package/helpers/env-resolver.ts +69 -0
  319. package/helpers/form-filler.ts +126 -0
  320. package/helpers/modal-handler.ts +108 -0
  321. package/helpers/navigation.ts +100 -0
  322. package/helpers/quality-gate.ts +180 -0
  323. package/helpers/screenshot.ts +111 -0
  324. package/helpers/seed-validator.ts +70 -0
  325. package/package.json +88 -0
package/core/__tests__/report-upload.test.ts ADDED
@@ -0,0 +1,325 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
+
3
+ // ── Mock node:fs/promises ─────────────────────────────────────────────────
4
+ vi.mock('node:fs/promises', () => ({
5
+ readFile: vi.fn(),
6
+ copyFile: vi.fn().mockResolvedValue(undefined),
7
+ mkdir: vi.fn().mockResolvedValue(undefined),
8
+ stat: vi.fn().mockResolvedValue({ size: 1234 }),
9
+ }));
10
+
11
+ // ── Mock node:module (createRequire) ──────────────────────────────────────
12
+ const mockRequire = vi.fn();
13
+ vi.mock('node:module', () => ({
14
+ createRequire: vi.fn(() => mockRequire),
15
+ }));
16
+
17
+ import { readFile, copyFile, mkdir, stat } from 'node:fs/promises';
18
+ import { uploadReport, getDefaultUploadConfig } from '../report-upload';
19
+ import type { UploadConfig } from '../report-upload';
20
+
21
+ beforeEach(() => {
22
+ vi.clearAllMocks();
23
+ vi.mocked(readFile).mockResolvedValue(Buffer.from('<html>report</html>'));
24
+ vi.mocked(stat).mockResolvedValue({ size: 1234 } as any);
25
+ vi.mocked(copyFile).mockResolvedValue(undefined);
26
+ vi.mocked(mkdir).mockResolvedValue(undefined as any);
27
+
28
+ // Reset Date to deterministic value for filename generation
29
+ vi.useFakeTimers();
30
+ vi.setSystemTime(new Date('2025-06-15T12:30:45.123Z'));
31
+ });
32
+
33
+ afterEach(() => {
34
+ vi.useRealTimers();
35
+ vi.restoreAllMocks();
36
+ });
37
+
38
+ // ═══════════════════════════════════════════════════════════════════════════
39
+ // getDefaultUploadConfig
40
+ // ═══════════════════════════════════════════════════════════════════════════
41
+
42
+ describe('getDefaultUploadConfig', () => {
43
+ it('returns local provider with default prefix', () => {
44
+ const config = getDefaultUploadConfig();
45
+ expect(config.provider).toBe('local');
46
+ expect(config.prefix).toBe('testteam-reports/');
47
+ });
48
+ });
49
+
50
+ // ═══════════════════════════════════════════════════════════════════════════
51
+ // uploadReport — local provider
52
+ // ═══════════════════════════════════════════════════════════════════════════
53
+
54
+ describe('uploadReport — local', () => {
55
+ const localConfig: UploadConfig = {
56
+ provider: 'local',
57
+ prefix: 'test-reports/',
58
+ };
59
+
60
+ it('copies file to reports directory and returns file:// URL', async () => {
61
+ const result = await uploadReport('/tmp/report.html', localConfig);
62
+
63
+ expect(mkdir).toHaveBeenCalledWith(expect.any(String), { recursive: true });
64
+ expect(copyFile).toHaveBeenCalled();
65
+ expect(result.provider).toBe('local');
66
+ expect(result.url).toMatch(/^file:\/\//);
67
+ expect(result.url).toContain('report-2025-06-15T12-30-45-123Z.html');
68
+ expect(result.size).toBe(1234);
69
+ expect(result.timestamp).toBeTypeOf('number');
70
+ });
71
+
72
+ it('uses default prefix when none specified', async () => {
73
+ const config: UploadConfig = { provider: 'local' };
74
+
75
+ const result = await uploadReport('/tmp/report.html', config);
76
+
77
+ expect(result.provider).toBe('local');
78
+ expect(mkdir).toHaveBeenCalled();
79
+ });
80
+
81
+ it('verifies file exists before upload', async () => {
82
+ vi.mocked(stat).mockRejectedValueOnce(new Error('ENOENT'));
83
+
84
+ await expect(uploadReport('/tmp/missing.html', localConfig))
85
+ .rejects.toThrow('ENOENT');
86
+ });
87
+ });
88
+
89
+ // ═══════════════════════════════════════════════════════════════════════════
90
+ // uploadReport — S3 provider
91
+ // ═══════════════════════════════════════════════════════════════════════════
92
+
93
+ describe('uploadReport — S3', () => {
94
+ const s3Config: UploadConfig = {
95
+ provider: 's3',
96
+ bucket: 'my-bucket',
97
+ region: 'eu-west-1',
98
+ prefix: 'reports/',
99
+ };
100
+
101
+ it('uploads to S3 with correct bucket and key', async () => {
102
+ const mockSend = vi.fn().mockResolvedValue({});
103
+ const mockS3Client = vi.fn(() => ({ send: mockSend }));
104
+ const mockPutObjectCommand = vi.fn((params: unknown) => params);
105
+
106
+ mockRequire.mockReturnValue({
107
+ S3Client: mockS3Client,
108
+ PutObjectCommand: mockPutObjectCommand,
109
+ });
110
+
111
+ const result = await uploadReport('/tmp/report.html', s3Config);
112
+
113
+ expect(result.provider).toBe('s3');
114
+ expect(result.url).toContain('my-bucket.s3.eu-west-1.amazonaws.com');
115
+ expect(result.url).toContain('reports/');
116
+ expect(result.size).toBeGreaterThan(0);
117
+
118
+ expect(mockS3Client).toHaveBeenCalledWith({ region: 'eu-west-1' });
119
+ expect(mockPutObjectCommand).toHaveBeenCalledWith(
120
+ expect.objectContaining({
121
+ Bucket: 'my-bucket',
122
+ ContentType: 'text/html',
123
+ }),
124
+ );
125
+ expect(mockSend).toHaveBeenCalled();
126
+ });
127
+
128
+ it('uses default region us-east-1 when not specified', async () => {
129
+ const mockSend = vi.fn().mockResolvedValue({});
130
+ const mockS3Client = vi.fn(() => ({ send: mockSend }));
131
+
132
+ mockRequire.mockReturnValue({
133
+ S3Client: mockS3Client,
134
+ PutObjectCommand: vi.fn((p: unknown) => p),
135
+ });
136
+
137
+ const config: UploadConfig = { provider: 's3', bucket: 'test-bucket' };
138
+ const result = await uploadReport('/tmp/report.html', config);
139
+
140
+ expect(result.url).toContain('s3.us-east-1.amazonaws.com');
141
+ expect(mockS3Client).toHaveBeenCalledWith({ region: 'us-east-1' });
142
+ });
143
+
144
+ it('uses default prefix when none specified', async () => {
145
+ const mockSend = vi.fn().mockResolvedValue({});
146
+ mockRequire.mockReturnValue({
147
+ S3Client: vi.fn(() => ({ send: mockSend })),
148
+ PutObjectCommand: vi.fn((p: unknown) => p),
149
+ });
150
+
151
+ const config: UploadConfig = { provider: 's3', bucket: 'b' };
152
+ const result = await uploadReport('/tmp/report.html', config);
153
+
154
+ expect(result.url).toContain('testteam-reports/');
155
+ });
156
+
157
+ it('throws when @aws-sdk/client-s3 is not installed', async () => {
158
+ mockRequire.mockImplementation(() => {
159
+ throw new Error('Cannot find module');
160
+ });
161
+
162
+ await expect(uploadReport('/tmp/report.html', s3Config))
163
+ .rejects.toThrow('Install @aws-sdk/client-s3');
164
+ });
165
+
166
+ it('throws when bucket is missing', async () => {
167
+ mockRequire.mockReturnValue({
168
+ S3Client: vi.fn(),
169
+ PutObjectCommand: vi.fn(),
170
+ });
171
+
172
+ const config: UploadConfig = { provider: 's3' };
173
+
174
+ await expect(uploadReport('/tmp/report.html', config))
175
+ .rejects.toThrow('S3 upload requires a bucket name');
176
+ });
177
+ });
178
+
179
+ // ═══════════════════════════════════════════════════════════════════════════
180
+ // uploadReport — Azure Blob provider
181
+ // ═══════════════════════════════════════════════════════════════════════════
182
+
183
+ describe('uploadReport — Azure Blob', () => {
184
+ const azureConfig: UploadConfig = {
185
+ provider: 'azure-blob',
186
+ bucket: 'my-container',
187
+ connectionString: 'DefaultEndpointsProtocol=https;AccountName=test',
188
+ prefix: 'reports/',
189
+ };
190
+
191
+ it('uploads to Azure Blob with correct container and blob name', async () => {
192
+ const mockUpload = vi.fn().mockResolvedValue({});
193
+ const mockBlockBlobClient = {
194
+ upload: mockUpload,
195
+ url: 'https://test.blob.core.windows.net/my-container/reports/report.html',
196
+ };
197
+ const mockContainerClient = {
198
+ createIfNotExists: vi.fn().mockResolvedValue({}),
199
+ getBlockBlobClient: vi.fn(() => mockBlockBlobClient),
200
+ };
201
+ const mockBlobServiceClient = {
202
+ getContainerClient: vi.fn(() => mockContainerClient),
203
+ };
204
+
205
+ mockRequire.mockReturnValue({
206
+ BlobServiceClient: {
207
+ fromConnectionString: vi.fn(() => mockBlobServiceClient),
208
+ },
209
+ });
210
+
211
+ const result = await uploadReport('/tmp/report.html', azureConfig);
212
+
213
+ expect(result.provider).toBe('azure-blob');
214
+ expect(result.url).toContain('blob.core.windows.net');
215
+ expect(result.size).toBeGreaterThan(0);
216
+
217
+ expect(mockContainerClient.createIfNotExists).toHaveBeenCalledWith({ access: 'blob' });
218
+ expect(mockUpload).toHaveBeenCalledWith(
219
+ expect.any(Buffer),
220
+ expect.any(Number),
221
+ expect.objectContaining({
222
+ blobHTTPHeaders: { blobContentType: 'text/html' },
223
+ }),
224
+ );
225
+ });
226
+
227
+ it('throws when @azure/storage-blob is not installed', async () => {
228
+ mockRequire.mockImplementation(() => {
229
+ throw new Error('Cannot find module');
230
+ });
231
+
232
+ await expect(uploadReport('/tmp/report.html', azureConfig))
233
+ .rejects.toThrow('Install @azure/storage-blob');
234
+ });
235
+
236
+ it('throws when connectionString is missing', async () => {
237
+ mockRequire.mockReturnValue({
238
+ BlobServiceClient: { fromConnectionString: vi.fn() },
239
+ });
240
+
241
+ const config: UploadConfig = { provider: 'azure-blob', bucket: 'c' };
242
+
243
+ await expect(uploadReport('/tmp/report.html', config))
244
+ .rejects.toThrow('connectionString');
245
+ });
246
+
247
+ it('throws when bucket (container name) is missing', async () => {
248
+ mockRequire.mockReturnValue({
249
+ BlobServiceClient: { fromConnectionString: vi.fn() },
250
+ });
251
+
252
+ const config: UploadConfig = {
253
+ provider: 'azure-blob',
254
+ connectionString: 'DefaultEndpointsProtocol=https;AccountName=test',
255
+ };
256
+
257
+ await expect(uploadReport('/tmp/report.html', config))
258
+ .rejects.toThrow('container name');
259
+ });
260
+
261
+ it('uses default prefix when none specified', async () => {
262
+ const mockBlockBlobClient = {
263
+ upload: vi.fn().mockResolvedValue({}),
264
+ url: 'https://test.blob.core.windows.net/c/testteam-reports/report.html',
265
+ };
266
+ const mockContainerClient = {
267
+ createIfNotExists: vi.fn().mockResolvedValue({}),
268
+ getBlockBlobClient: vi.fn(() => mockBlockBlobClient),
269
+ };
270
+ const mockBlobServiceClient = {
271
+ getContainerClient: vi.fn(() => mockContainerClient),
272
+ };
273
+
274
+ mockRequire.mockReturnValue({
275
+ BlobServiceClient: {
276
+ fromConnectionString: vi.fn(() => mockBlobServiceClient),
277
+ },
278
+ });
279
+
280
+ const config: UploadConfig = {
281
+ provider: 'azure-blob',
282
+ bucket: 'c',
283
+ connectionString: 'conn',
284
+ };
285
+
286
+ const result = await uploadReport('/tmp/report.html', config);
287
+ expect(result.provider).toBe('azure-blob');
288
+
289
+ // Verify getBlockBlobClient was called with a blob name containing default prefix
290
+ const blobName = (mockContainerClient.getBlockBlobClient.mock.calls as unknown[][])[0][0] as string;
291
+ expect(blobName).toMatch(/^testteam-reports\//);
292
+ });
293
+ });
294
+
295
+ // ═══════════════════════════════════════════════════════════════════════════
296
+ // uploadReport — file existence check
297
+ // ═══════════════════════════════════════════════════════════════════════════
298
+
299
+ describe('uploadReport — file verification', () => {
300
+ it('throws when file does not exist (stat fails)', async () => {
301
+ // stat is called first in uploadReport to verify existence
302
+ vi.mocked(stat)
303
+ .mockRejectedValueOnce(new Error('ENOENT: no such file'));
304
+
305
+ const config: UploadConfig = { provider: 'local' };
306
+
307
+ await expect(uploadReport('/tmp/missing.html', config))
308
+ .rejects.toThrow('ENOENT');
309
+ });
310
+ });
311
+
312
+ // ═══════════════════════════════════════════════════════════════════════════
313
+ // Report filename generation
314
+ // ═══════════════════════════════════════════════════════════════════════════
315
+
316
+ describe('report filename generation', () => {
317
+ it('generates timestamped filename from original path', async () => {
318
+ const config: UploadConfig = { provider: 'local', prefix: 'out/' };
319
+
320
+ const result = await uploadReport('/tmp/my-report.html', config);
321
+
322
+ // Filename should be: my-report-2025-06-15T12-30-45-123Z.html
323
+ expect(result.url).toContain('my-report-2025-06-15T12-30-45-123Z.html');
324
+ });
325
+ });
package/core/__tests__/run-counter.test.ts ADDED
@@ -0,0 +1,234 @@
1
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
2
+ import * as fs from 'node:fs';
3
+ import * as os from 'node:os';
4
+ import * as path from 'node:path';
5
+ import {
6
+ getRunCounterPath,
7
+ loadRunCounter,
8
+ recordRun,
9
+ checkRunLimit,
10
+ resetRunCounter,
11
+ _periodStartFor,
12
+ _periodEndFor,
13
+ } from '../run-counter';
14
+
15
+ describe('RunCounter', () => {
16
+ let tmpDir: string;
17
+
18
+ beforeEach(() => {
19
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tf-run-counter-'));
20
+ });
21
+
22
+ afterEach(() => {
23
+ vi.restoreAllMocks();
24
+ fs.rmSync(tmpDir, { recursive: true, force: true });
25
+ });
26
+
27
+ // ── getRunCounterPath ───────────────────────────────────────────
28
+
29
+ describe('getRunCounterPath()', () => {
30
+ it('returns path ending with .testteam-runs.json', () => {
31
+ const p = getRunCounterPath(tmpDir);
32
+ expect(p).toBe(path.join(tmpDir, '.testteam-runs.json'));
33
+ });
34
+ });
35
+
36
+ // ── loadRunCounter ──────────────────────────────────────────────
37
+
38
+ describe('loadRunCounter()', () => {
39
+ it('fresh state starts at 0 runs', () => {
40
+ const state = loadRunCounter(tmpDir);
41
+ expect(state.totalRuns).toBe(0);
42
+ expect(state.runs).toEqual([]);
43
+ });
44
+
45
+ it('creates the file on first load', () => {
46
+ loadRunCounter(tmpDir);
47
+ expect(fs.existsSync(getRunCounterPath(tmpDir))).toBe(true);
48
+ });
49
+
50
+ it('returns persisted state on second load', () => {
51
+ recordRun(tmpDir, 'alpha', 'smoke');
52
+ const state = loadRunCounter(tmpDir);
53
+ expect(state.totalRuns).toBe(1);
54
+ });
55
+
56
+ it('auto-resets when period has expired', () => {
57
+ // Write a state with an expired period
58
+ const expired = {
59
+ periodStart: Date.UTC(2024, 0, 1),
60
+ periodEnd: Date.UTC(2024, 0, 31, 23, 59, 59, 999),
61
+ runs: [{ timestamp: Date.UTC(2024, 0, 15), phase: 'alpha', configName: 'old' }],
62
+ totalRuns: 1,
63
+ };
64
+ fs.writeFileSync(getRunCounterPath(tmpDir), JSON.stringify(expired), 'utf8');
65
+
66
+ const state = loadRunCounter(tmpDir);
67
+ expect(state.totalRuns).toBe(0);
68
+ expect(state.runs).toEqual([]);
69
+ // Period should be for the current month, not 2024-01
70
+ expect(state.periodStart).toBeGreaterThan(expired.periodEnd);
71
+ });
72
+
73
+ it('handles corrupted file gracefully', () => {
74
+ fs.writeFileSync(getRunCounterPath(tmpDir), '{{not json}}', 'utf8');
75
+ const state = loadRunCounter(tmpDir);
76
+ expect(state.totalRuns).toBe(0);
77
+ });
78
+
79
+ it('handles file with invalid schema gracefully', () => {
80
+ fs.writeFileSync(getRunCounterPath(tmpDir), JSON.stringify({ bad: true }), 'utf8');
81
+ const state = loadRunCounter(tmpDir);
82
+ expect(state.totalRuns).toBe(0);
83
+ });
84
+ });
85
+
86
+ // ── recordRun ───────────────────────────────────────────────────
87
+
88
+ describe('recordRun()', () => {
89
+ it('recording a run increments counter', () => {
90
+ recordRun(tmpDir, 'alpha', 'smoke');
91
+ const state = loadRunCounter(tmpDir);
92
+ expect(state.totalRuns).toBe(1);
93
+ expect(state.runs).toHaveLength(1);
94
+ expect(state.runs[0].phase).toBe('alpha');
95
+ expect(state.runs[0].configName).toBe('smoke');
96
+ expect(state.runs[0].timestamp).toBeGreaterThan(0);
97
+ });
98
+
99
+ it('accumulates multiple runs', () => {
100
+ recordRun(tmpDir, 'alpha', 'smoke');
101
+ recordRun(tmpDir, 'beta', 'regression');
102
+ recordRun(tmpDir, 'uat', 'full');
103
+ const state = loadRunCounter(tmpDir);
104
+ expect(state.totalRuns).toBe(3);
105
+ expect(state.runs).toHaveLength(3);
106
+ });
107
+ });
108
+
109
+ // ── checkRunLimit ───────────────────────────────────────────────
110
+
111
+ describe('checkRunLimit()', () => {
112
+ it('allows when under limit', () => {
113
+ recordRun(tmpDir, 'alpha', 'smoke');
114
+ const result = checkRunLimit(tmpDir, 10);
115
+ expect(result.allowed).toBe(true);
116
+ expect(result.used).toBe(1);
117
+ expect(result.remaining).toBe(9);
118
+ expect(result.warning).toBe(false);
119
+ });
120
+
121
+ it('warns at 80% threshold', () => {
122
+ // Record 8 of 10 runs
123
+ for (let i = 0; i < 8; i++) {
124
+ recordRun(tmpDir, 'alpha', `run-${i}`);
125
+ }
126
+ const result = checkRunLimit(tmpDir, 10);
127
+ expect(result.allowed).toBe(true);
128
+ expect(result.used).toBe(8);
129
+ expect(result.remaining).toBe(2);
130
+ expect(result.warning).toBe(true);
131
+ });
132
+
133
+ it('blocks when at limit', () => {
134
+ for (let i = 0; i < 10; i++) {
135
+ recordRun(tmpDir, 'alpha', `run-${i}`);
136
+ }
137
+ const result = checkRunLimit(tmpDir, 10);
138
+ expect(result.allowed).toBe(false);
139
+ expect(result.used).toBe(10);
140
+ expect(result.remaining).toBe(0);
141
+ expect(result.warning).toBe(true);
142
+ });
143
+
144
+ it('blocks when over limit', () => {
145
+ // Manually write state with 15 runs, limit is 10
146
+ const state = loadRunCounter(tmpDir);
147
+ for (let i = 0; i < 15; i++) {
148
+ state.runs.push({ timestamp: Date.now(), phase: 'alpha', configName: `run-${i}` });
149
+ }
150
+ state.totalRuns = 15;
151
+ fs.writeFileSync(getRunCounterPath(tmpDir), JSON.stringify(state), 'utf8');
152
+
153
+ const result = checkRunLimit(tmpDir, 10);
154
+ expect(result.allowed).toBe(false);
155
+ expect(result.used).toBe(15);
156
+ expect(result.remaining).toBe(0);
157
+ });
158
+
159
+ it('returns correct state with zero runs', () => {
160
+ const result = checkRunLimit(tmpDir, 100);
161
+ expect(result.allowed).toBe(true);
162
+ expect(result.used).toBe(0);
163
+ expect(result.remaining).toBe(100);
164
+ expect(result.warning).toBe(false);
165
+ });
166
+
167
+ it('does not warn below 80% threshold', () => {
168
+ for (let i = 0; i < 7; i++) {
169
+ recordRun(tmpDir, 'alpha', `run-${i}`);
170
+ }
171
+ // 7/10 = 70%, below 80%
172
+ const result = checkRunLimit(tmpDir, 10);
173
+ expect(result.warning).toBe(false);
174
+ });
175
+ });
176
+
177
+ // ── resetRunCounter ─────────────────────────────────────────────
178
+
179
+ describe('resetRunCounter()', () => {
180
+ it('manual reset clears all runs', () => {
181
+ recordRun(tmpDir, 'alpha', 'smoke');
182
+ recordRun(tmpDir, 'beta', 'regression');
183
+ expect(loadRunCounter(tmpDir).totalRuns).toBe(2);
184
+
185
+ resetRunCounter(tmpDir);
186
+
187
+ const state = loadRunCounter(tmpDir);
188
+ expect(state.totalRuns).toBe(0);
189
+ expect(state.runs).toEqual([]);
190
+ });
191
+
192
+ it('reset sets a fresh period for the current month', () => {
193
+ resetRunCounter(tmpDir);
194
+ const state = loadRunCounter(tmpDir);
195
+ const now = new Date();
196
+ const expectedStart = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1);
197
+ expect(state.periodStart).toBe(expectedStart);
198
+ });
199
+ });
200
+
201
+ // ── Period calculation ──────────────────────────────────────────
202
+
203
+ describe('period calculation', () => {
204
+ it('calculates correct period for January (31 days)', () => {
205
+ const jan = new Date(Date.UTC(2025, 0, 15));
206
+ expect(_periodStartFor(jan)).toBe(Date.UTC(2025, 0, 1));
207
+ expect(_periodEndFor(jan)).toBe(Date.UTC(2025, 0, 31, 23, 59, 59, 999));
208
+ });
209
+
210
+ it('calculates correct period for February non-leap year (28 days)', () => {
211
+ const feb = new Date(Date.UTC(2025, 1, 10));
212
+ expect(_periodStartFor(feb)).toBe(Date.UTC(2025, 1, 1));
213
+ expect(_periodEndFor(feb)).toBe(Date.UTC(2025, 1, 28, 23, 59, 59, 999));
214
+ });
215
+
216
+ it('calculates correct period for February leap year (29 days)', () => {
217
+ const feb = new Date(Date.UTC(2024, 1, 10));
218
+ expect(_periodStartFor(feb)).toBe(Date.UTC(2024, 1, 1));
219
+ expect(_periodEndFor(feb)).toBe(Date.UTC(2024, 1, 29, 23, 59, 59, 999));
220
+ });
221
+
222
+ it('calculates correct period for April (30 days)', () => {
223
+ const apr = new Date(Date.UTC(2025, 3, 20));
224
+ expect(_periodStartFor(apr)).toBe(Date.UTC(2025, 3, 1));
225
+ expect(_periodEndFor(apr)).toBe(Date.UTC(2025, 3, 30, 23, 59, 59, 999));
226
+ });
227
+
228
+ it('calculates correct period for December (31 days)', () => {
229
+ const dec = new Date(Date.UTC(2025, 11, 25));
230
+ expect(_periodStartFor(dec)).toBe(Date.UTC(2025, 11, 1));
231
+ expect(_periodEndFor(dec)).toBe(Date.UTC(2025, 11, 31, 23, 59, 59, 999));
232
+ });
233
+ });
234
+ });